共用方式為

客戶數據物件 - 客戶管理

  • 發行項

定義包含一或多個廣告帳戶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 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 應用程式。

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

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

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

加： 唯讀
更新： 必填		 base64Binary

需求

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

消費者

GetCustomer
SearchCustomers
SignupCustomer
UpdateCustomer