用戶資料物件 - 客戶管理
定義Microsoft Advertising 用戶的個人和業務聯繫人資訊。
您可以將多個用戶物件指派給同一個人，也就是每個客戶一個使用者。 相同人員的 Name、Lcid、JobTitle 和 ContactInfo 使用者設定，將會自動與用戶匯總之後發生的任何更新同步。 LastModifiedByUserId 和 LastModifiedTime 也會在每個傳回的 User 物件之間同步，除非您合併了舊的用戶名稱，而且自合併之後尚未更新任何使用者設定。
提示
透過 Microsoft Advertising 多使用者認證，您可以接受邀請，以使用您現有的 Microsoft Advertising 認證來管理個別客戶。 如需詳細資訊，請參閱 多使用者認證 技術指南。
語法
<xs:complexType name="User" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="ContactInfo" nillable="true" type="tns:ContactInfo" />
<xs:element minOccurs="0" name="CustomerId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="JobTitle" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="LastModifiedByUserId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="LastModifiedTime" nillable="true" type="xs:dateTime" />
<xs:element minOccurs="0" name="Lcid" nillable="true" type="tns:LCID" />
<xs:element minOccurs="0" name="Name" nillable="true" type="tns:PersonName" />
<xs:element minOccurs="0" name="Password" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="SecretAnswer" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="SecretQuestion" type="tns:SecretQuestion" />
<xs:element minOccurs="0" name="UserLifeCycleStatus" nillable="true" type="tns:UserLifeCycleStatus" />
<xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
<xs:element minOccurs="0" name="UserName" nillable="true" type="xs:string" />
<xs:element xmlns:q6="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q6:ArrayOfKeyValuePairOfstringstring" />
<xs:element minOccurs="0" name="AuthenticationToken" nillable="true" type="xs:string">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
元素
User 物件具有下列元素：AuthenticationToken、ContactInfo、CustomerId、ForwardCompatibilityMap、Id、JobTitle、LastModifiedByUserId、LastModifiedTime、Lcid、Name、Password、SecretAnswer、SecretQuestion、TimeStamp、UserLifeCycleStatus、UserName。
| 元素 | 描述 | 資料類型 |
|---|---|---|
| AuthenticationToken | OAuth 存取令牌，代表有權Microsoft Advertising 帳戶的用戶認證。 如需詳細資訊，請 參閱使用 OAuth 進行驗證。 更新： 唯讀 |
string |
| ContactInfo | 用戶的聯繫人資訊。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
ContactInfo |
| CustomerId | 要存取此使用者的客戶識別碼。 更新： 唯讀 |
長 |
| ForwardCompatibilityMap | 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。 未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。 |
KeyValuePairOfstringstring 陣 列 |
| 標識碼 | 使用者的 Microsoft Advertising 識別碼。 更新： 必填 |
長 |
| JobTitle | 用戶的職稱。 標題最多可以包含 50 個字元。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
string |
| LastModifiedByUserId | 要更新使用者信息的最後一個使用者標識碼。 更新： 唯讀 |
長 |
| LastModifiedTime | 上次更新使用者資訊的日期和時間。 值為國際標準時間 (UTC)。 日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。 更新： 唯讀 |
dateTime |
| Lcid | 透過電子郵件或郵件傳送信件給使用者時所要使用的地區設定。 預設值為 EnglishUS。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
LCID |
| 名稱 | 用戶的名稱。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
PersonName |
| 密碼 | 此元素會保留供內部使用，並會從未來的 API 版本中移除。 GetUser 作業不會傳回密碼。 更新： 唯讀 |
string |
| SecretAnswer | 此元素會保留供內部使用，並會從未來的 API 版本中移除。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
string |
| SecretQuestion | 此元素會保留供內部使用，並會從未來的 API 版本中移除。 更新： 自選。 如果未設定更新的值，則此設定不會變更。 |
SecretQuestion |
| 時間戳 | 當您呼叫 UpdateUser 或 DeleteUser 時，系統在內部用來協調更新的時間戳值。 更新： 必填 |
base64Binary |
| UserLifeCycleStatus | 用戶的狀態。 更新： 唯讀 |
UserLifeCycleStatus |
| UserName | 使用者的登入用戶名稱。 Microsoft 帳戶的電子郵件位址可能與 ContactInfo 物件的 Email 元素不同。 更新： 唯讀 |
string |
需求
服務： CustomerManagementService.svc v13
Namespace： https://bingads.microsoft.com/Customer/v13/Entities