Customer Data Object - Customer Management

  • [アーティクル]

1 つ以上の 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 顧客の財務状態。 たとえば、状態は、顧客が良好な状態にあるか、1 つ以上のアカウントが期限を過ぎているかを示します。

追加： 読み 取り 専用
更新： 読み 取り 専用		 CustomerFinancialStatus
CustomerLifeCycleStatus 顧客の状態。 顧客を作成すると、状態は [アクティブ] に設定されます。 状態を変更することはできません。

追加： 読み 取り 専用
更新： 読み 取り 専用		 CustomerLifeCycleStatus
ForwardCompatibilityMap 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。

今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、このオブジェクトの前方互換性の変更はありません。		 KeyValuePairOfstring 配列
Id システムによって生成された顧客識別子。

この識別子は、 CustomerId SOAP ヘッダー要素を必要とする操作要求で使用します。

追加： 読み 取り 専用
更新： 必須		 long
業界 自動車、食品、娯楽など、顧客の主要な事業セグメント。

追加： 必須
更新： 必須		 業界
LastModifiedByUserId 顧客の情報を更新する最後のユーザーの識別子。

追加： 読み 取り 専用
更新： 読み 取り 専用		 long
LastModifiedTime 顧客情報が最後に更新された日時。 値は、世界協定時刻 (UTC) です。

日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「プリミティブ XML データ型」の dateTime エントリを参照してください。

追加： 読み 取り 専用
更新： 読み 取り 専用		 dateTime
MarketCountry 顧客が運営する主要国。 顧客市場の国コード値の一覧については、「 製品言語」を参照してください。

追加： 必須
更新： 読み 取り 専用		 string
MarketLanguage 顧客が使用する主な言語。 顧客市場の言語によって、Microsoft Advertising インターフェイスの言語が決まります。 顧客市場言語コード値の一覧については、「 製品言語」を参照してください。

追加： 必須
更新： 読み 取り 専用		 LanguageType
名前 顧客の名前。

名前には、最大 90 文字を含めることができます。

追加： 必須
更新： 必須		 string
数値 Microsoft Advertising Web アプリケーションで使用されるシステム生成の顧客番号。

顧客番号には xxxxxxxxxx という形式があります。 ここで、xxxxxxxxxx は任意の 10 文字の英数字の系列です。

追加： 読み 取り 専用
更新： 読み 取り 専用		 string
ServiceLevel 内部使用のみ。 SignupCustomer を呼び出すときにこの要素が設定されている場合、エラーが返されます。 UpdateCustomer を呼び出すときにこの要素が設定されている場合、要素は無視されます。

追加： 読み 取り 専用
更新： 読み 取り 専用		 ServiceLevel
タイムスタンプ UpdateCustomer 操作と DeleteCustomer 操作を呼び出すときに、システムが内部的に更新プログラムを調整するために使用するタイム スタンプ値。

追加： 読み 取り 専用
更新： 必須		 base64Binary

要件

サービス: CustomerManagementService.svc v13
名前 空間： https://bingads.microsoft.com/Customer/v13/Entities

Used By

GetCustomer
SearchCustomers
SignupCustomer
UpdateCustomer