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 オブジェクトには、AccountIdsCustomerIdEmailExpirationDateFirstNameIdLastNameLcidRoleId の各要素があります。

要素 説明 データ型
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

使用ページ

SearchUserInvitations
SendUserInvitation
SignupCustomer