ユーザー データ オブジェクト - Customer Management

  • [アーティクル]

Microsoft Advertising ユーザーに関する個人とビジネスの連絡先情報を定義します。

複数のユーザー オブジェクトを同じユーザーに割り当てることができます。つまり、顧客ごとに 1 人につき 1 人のユーザーを割り当てることができます。 同じユーザーの名前、Lcid、JobTitle、ContactInfo の各ユーザー設定は、ユーザー統合後に発生した更新プログラムと自動的に同期されます。 LastModifiedByUserId と LastModifiedTime は、古いユーザー名をマージし、統合以降にユーザー設定を更新していない限り、返された各 User オブジェクト間でも同期されます。

ヒント

Microsoft Advertising マルチユーザー資格情報を使用すると、既存の Microsoft Advertising 資格情報を使用して別の顧客を管理するための招待を承諾できます。 詳細については、 マルチユーザー資格情報 のテクニカル ガイドを参照してください。

構文

<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 Microsoft Advertising アカウントへのアクセス許可を持つユーザーの資格情報を表す OAuth アクセス トークン。

詳細については、「 OAuth による認証」を参照してください。

更新： 読み 取り 専用		 string
ContactInfo ユーザーの連絡先情報。

更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 ContactInfo
Customerid このユーザーがアクセスするための顧客の識別子。

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

今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、このオブジェクトの前方互換性の変更はありません。		 KeyValuePairOfstring 配列
Id ユーザーの Microsoft Advertising 識別子。

更新： 必須		 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
名 ユーザーのログオン ユーザー名。

Microsoft アカウントのメール アドレスは 、ContactInfo オブジェクトの Email 要素と異なる場合があります。

更新： 読み 取り 専用		 string

要件

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

Used By

GetUser
SignupCustomer
UpdateUser