共用方式為

客戶資料物件 - 客戶管理

  • 發行項

定義包含一或多個 Microsoft Advertising 帳戶的客戶物件。

語法

<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 Advertising 不會使用此屬性，您必須改為設定帳戶商務位址。

添加： 選
更新： 選		 Address
CustomerFinancialStatus 客戶的財務狀態。 例如，狀態會指出客戶是否處於良好狀態，或一或多個帳戶已逾期。

添加： 唯讀
更新： 唯讀		 CustomerFinancialStatus
CustomerLifeCycleStatus 客戶的狀態。 當您建立客戶時，狀態會設定為 [作用中]。 您無法變更狀態。

添加： 唯讀
更新： 唯讀		 CustomerLifeCycleStatus
ForwardCompatibilityMap 用於向前相容性的索引鍵和值字串清單，以避免在目前 API 版本中新增新元素時中斷變更。

未來的版本中將會記下向前相容性變更。 此物件目前沒有向前相容性變更。		 KeyValuePairOfstringstring 數 組
識別碼 系統產生的客戶識別碼。

使用此識別碼搭配需要 CustomerId SOAP 標頭元素的作業要求。

添加： 唯讀
更新： 必填		 長
產業 客戶的主要業務區段，例如汽車、食物或娛樂。

添加： 必填
更新： 必填		 產業
LastModifiedByUserId 要更新客戶資訊的最後一個使用者識別碼。

添加： 唯讀
更新： 唯讀		 長
LastModifiedTime 上次更新客戶資訊的日期和時間。 值為國際標準時間 (UTC)。

日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關資訊，請參閱基本 XML 資料類型中的dateTime專案。

添加： 唯讀
更新： 唯讀		 Datetime
MarketCountry 客戶運作的主要國家/地區。 如需客戶市場國家/地區代碼值的清單，請參閱 產品語言。

添加： 必填
更新： 唯讀		 string
MarketLanguage 客戶使用的主要語言。 您的客戶市場語言會決定 Microsoft Advertising 介面的語言。 如需客戶市場語言代碼值的清單，請參閱 產品語言。

添加： 必填
更新： 唯讀		 LanguageType
名稱 客戶的名稱。

名稱最多可以包含 90 個字元。

添加： 必填
更新： 必填		 string
數字 系統產生的客戶號碼，用於 Microsoft Advertising Web 應用程式。

客戶編碼的格式為 xxxxxxxxxx，其中 xxxxxxxxxx 是一系列的十個英數位元。

添加： 唯讀
更新： 唯讀		 string
ServiceLevel 僅限內部使用。 如果在呼叫 SignupCustomer 時設定此元素，則會傳回錯誤。 如果在呼叫 UpdateCustomer 時設定此元素，則會忽略元素。

添加： 唯讀
更新： 唯讀		 ServiceLevel
時間 戳 當您呼叫 UpdateCustomer 和 DeleteCustomer 作業時，系統在內部用來協調更新的時間戳記值。

添加： 唯讀
更新： 必填		 base64Binary

需求

服務： CustomerManagementService.svc v13
命名 空間： https://bingads.microsoft.com/Customer/v13/Entities

消費者

GetCustomer
SearchCustomers
SignupCustomer
UpdateCustomer