UserInvitation データ オブジェクト - Customer Management
ユーザーが Microsoft Advertising にサインアップするための招待を定義します。 招待により、アカウントのアクセスとアクセス許可が制限されます。
重要
招待が送信されると、顧客のすぐ下にある広告主アカウントのサブセットへのユーザー アクセスを制限できます。 ユーザーが招待された顧客の下で 代理店階層 が (現在または将来) 設定されていて、特定のアカウントへのアクセスを制限しない場合、ユーザーは階層内のすべてのアカウントにアクセスできます。
同じメール アドレスに複数の保留中の招待を送信できます。これは、まだ期限切れではありません。 また、不適切なユーザー ロールで招待を送信し、正しいユーザー ロールを持つ 2 つ目の招待を送信した場合など、それらの招待で異なるユーザー ロールを指定することもできます。 受信者は任意の招待を受け入れ、招待メール アドレスとは異なる資格情報でサインアップできます。 Microsoft Advertising ユーザーは、同じ資格情報を持つ複数の顧客への招待を受け入れます。 詳細については、 マルチユーザー資格情報 のテクニカル ガイドを参照してください。
招待 ID で保留中の招待を検索し、招待が承諾されたか期限切れになっているかを確認できます。 SearchUserInvitations 操作は、有効期限が切れているかどうかにかかわらず、保留中のすべての招待を返します。 受け入れられた招待は 、SearchUserInvitations 応答には含まれません。
招待が承諾されたら、GetUsersInfo と GetUser を呼び出して、Microsoft Advertising ユーザーの詳細にアクセスできます。 ただし、受信者は招待を受け入れ、招待メール アドレスとは異なる資格情報でサインアップできるため、UserInvitation から User または UserInfo オブジェクトへのマッピングを確実に判断することはできません。 GetUsersInfo または GetUser によって返されるユーザー ID を使用すると、DeleteUser を呼び出して、必要に応じてユーザーを削除できます。 Bing Ads API では、保留中のユーザー招待を削除する操作はサポートされていません。 ユーザーを招待した後、招待をキャンセルする唯一の方法は、Microsoft Advertising Web アプリケーションを使用することです。 保留中の招待と承諾された招待の両方は、[アカウント] & [課金] の [ユーザー] セクションにあります。
構文
<xs:complexType name="UserInvitation" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="Id" type="xs:long" />
<xs:element minOccurs="0" name="FirstName" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="LastName" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Email" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="CustomerId" type="xs:long" />
<xs:element minOccurs="0" name="RoleId" type="xs:int" />
<xs:element xmlns:q5="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="AccountIds" nillable="true" type="q5:ArrayOflong" />
<xs:element minOccurs="0" name="ExpirationDate" type="xs:dateTime" />
<xs:element minOccurs="0" name="Lcid" type="tns:LCID" />
</xs:sequence>
</xs:complexType>
要素
UserInvitation オブジェクトには、AccountIds、CustomerId、Email、ExpirationDate、FirstName、Id、LastName、Lcid、RoleId の各要素があります。
要素 | 説明 | データ型 |
---|---|---|
AccountIds | ユーザーが管理できるアカウントの識別子の配列。 ユーザーが属する顧客のすべての現在および将来のアカウントをユーザーが管理できることを指定するには、NULL に設定します。 広告主キャンペーン マネージャーなどのアカウント レベルのロールを持つユーザーは、特定のアカウントに制限できます。 Super 管理 などの顧客レベルのロールを持つユーザーは、ユーザーの顧客内のすべてのアカウントにアクセスでき、そのアクセスを特定のアカウントに制限することはできません。 スーパー 管理を特定のアカウントに制限するなど、顧客レベルのユーザー ロールを制限しようとすると、操作は失敗せず、指定した顧客内のすべてのアカウントに対するアクセス権がユーザーに付与されます。 送信: オプション サインアップ: オプション |
long 配列 |
Customerid | このユーザーが管理に招待される顧客の識別子。
AccountIds 要素は、ユーザーが管理できる顧客アカウントを決定します。 送信: 必須 サインアップ: 読み 取り 専用 |
long |
電子メール | ユーザーの Microsoft アカウントに対応する電子メール アドレス。 アドレスには、最大 100 文字を含めることができます。 送信: 必須 サインアップ: 必須 |
string |
ExpirationDate | ユーザーの招待の有効期限が切れる日時。 値は、世界協定時刻 (UTC) です。 ユーザー招待の期間は変更される可能性があり、現在は 30 日に設定されています。 この値を設定または更新することはできません。 送信: 読み 取り 専用 サインアップ: 読み 取り 専用 |
dateTime |
Firstname | ユーザーの名。 名は 40 文字に制限されています。 送信: 必須 サインアップ: 必須 |
string |
Id | ユーザー招待のシステム生成の一意識別子。 送信: 読み 取り 専用 サインアップ: 読み 取り 専用 |
long |
Lastname | ユーザーの姓。 姓は 40 文字に制限されています。 送信: 必須 サインアップ: 必須 |
string |
Lcid | メールまたは郵便でユーザーに連絡を送信するときに使用するロケール。 既定値は EnglishUS です。 送信: 必須 サインアップ: 必須 |
LCID |
RoleId | 顧客またはアカウントの一覧ごとにユーザーが持つロール。 以下のいずれかの値を使用できます。 16 - ユーザーは 広告主キャンペーン マネージャー ロールを持ちます。 33 - ユーザーは アグリゲーター ロールを持っています。 41 - ユーザーにスーパー 管理 ロールがあります。 100 - ユーザーは ビューアー ロールを持ちます。 203 - ユーザーは Standard User ロールを持っています。 詳細については、 ユーザー ロール のテクニカル ガイドを参照してください。 送信: 必須 サインアップ: 必須。 ロール ID は 41 または 203 に設定する必要があります。 |
int |
要件
サービス: CustomerManagementService.svc v13
Namespace: https://bingads.microsoft.com/Customer/v13/Entities