通过

用户数据对象 - 客户管理

  • 项目

定义有关Microsoft广告用户的个人和业务联系人信息。

可以将多个用户对象分配给同一个人，即每个客户每人一个用户。 同一人员的 Name、Lcid、JobTitle 和 ContactInfo 用户设置将自动与用户合并后发生的任何更新同步。 LastModifiedByUserId 和 LastModifiedTime 也会在每个返回 的 User 对象之间同步，除非你合并了旧用户名，并且自合并以来未更新任何用户设置。

提示

使用 Microsoft Advertising 多用户凭据，可以接受使用现有Microsoft广告凭据管理单独客户的邀请。 有关详细信息，请参阅 多用户凭据 技术指南。

语法

<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广告帐户的用户的凭据。

有关详细信息，请参阅 使用 OAuth 进行身份验证。

更新： 只读		 string
ContactInfo 用户的联系信息。

更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 ContactInfo
CustomerId 此用户要访问的客户标识符。

更新： 只读		 long
ForwardCompatibilityMap 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。

将来的版本中将在此处记录向前兼容性更改。 此对象当前没有向前兼容性更改。		 KeyValuePairOfstringstring 数组
ID 用户的Microsoft广告标识符。

更新： 必填		 long
JobTitle 用户的职务。 标题最多可以包含 50 个字符。

更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 string
LastModifiedByUserId 要更新用户信息的最后一个用户的标识符。

更新： 只读		 long
LastModifiedTime 上次更新用户信息的日期和时间。 该值以协调世界时 (UTC) 表示。

日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。

更新： 只读		 dateTime
Lcid 通过电子邮件或邮政邮件向用户发送信件时要使用的区域设置。 默认值为 EnglishUS。

更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 LCID
名称 用户的名称。

更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 PersonName
Password 此元素保留供内部使用，将从 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

使用者

GetUser
SignupCustomer
UpdateUser