通过

客户数据对象 - 客户管理

  • 项目

定义包含一个或多个Microsoft广告帐户的客户对象。

语法

<xs:complexType name="Customer" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CustomerFinancialStatus" nillable="true" type="tns:CustomerFinancialStatus" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Industry" nillable="true" type="tns:Industry" />
    <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="MarketCountry" nillable="true" type="xs:string" />
    <xs:element xmlns:q4="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q4:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="MarketLanguage" nillable="true" type="tns:LanguageType" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ServiceLevel" nillable="true" type="tns:ServiceLevel" />
    <xs:element minOccurs="0" name="CustomerLifeCycleStatus" nillable="true" type="tns:CustomerLifeCycleStatus" />
    <xs:element minOccurs="0" name="TimeStamp" nillable="true" type="xs:base64Binary" />
    <xs:element minOccurs="0" name="Number" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CustomerAddress" nillable="true" type="tns:Address" />
  </xs:sequence>
</xs:complexType>

元素

Customer 对象具有以下元素：CustomerAddress、CustomerFinancialStatus、CustomerLifeCycleStatus、ForwardCompatibilityMap、Id、Industry、LastModifiedByUserId、LastModifiedTime、MarketCountry、MarketLanguage、Name、Number、ServiceLevel、TimeStamp。

元素 说明 数据类型
CustomerAddress 客户的公司地址。

Microsoft广告不使用此属性，必须改为设置帐户业务地址。

加： 自选
更新： 自选		 地址
CustomerFinancialStatus 客户的财务状况。 例如，状态指示客户是信誉良好，还是一个或多个帐户逾期未付。

加： 只读
更新： 只读		 CustomerFinancialStatus
CustomerLifeCycleStatus 客户的状态。 创建客户时，状态设置为 “活动”。 无法更改状态。

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

将来的版本中将在此处记录向前兼容性更改。 此对象当前没有向前兼容性更改。		 KeyValuePairOfstringstring 数组
ID 系统生成的客户标识符。

将此标识符用于需要 CustomerId SOAP 标头元素的操作请求。

加： 只读
更新： 必填		 long
行业 客户的主要业务部门，例如汽车、食品或娱乐。

加： 必填
更新： 必填		 行业
LastModifiedByUserId 要更新客户信息的最后一个用户的标识符。

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

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

加： 只读
更新： 只读		 dateTime
MarketCountry 客户运营的主要国家/地区。 有关客户市场国家/地区代码值的列表，请参阅 产品语言。

加： 必填
更新： 只读		 string
MarketLanguage 客户使用的主要语言。 客户市场语言决定了Microsoft广告界面的语言。 有关客户市场语言代码值的列表，请参阅 产品语言。

加： 必填
更新： 只读		 LanguageType
名称 客户的名称。

名称最多可以包含 90 个字符。

加： 必填
更新： 必填		 string
数字 系统生成的客户编号，用于Microsoft广告 Web 应用程序。

客户编号的格式为 xxxxxxxxxx，其中 xxxxxxxxxx 是任意 10 个字母数字字符的系列。

加： 只读
更新： 只读		 string
ServiceLevel 仅供内部使用。 如果在调用 SignupCustomer 时设置此元素，将返回错误。 如果在调用 UpdateCustomer 时设置了此元素，则将忽略该元素。

加： 只读
更新： 只读		 ServiceLevel
时间戳 调用 UpdateCustomer 和 DeleteCustomer 操作时，系统内部使用该时间戳值来协调更新。

加： 只读
更新： 必填		 base64Binary

要求

服务： CustomerManagementService.svc v13
Namespace： https://bingads.microsoft.com/Customer/v13/Entities

使用者

GetCustomer
SearchCustomers
SignupCustomer
UpdateCustomer