共用方式為

UserInvitation 數據物件 - 客戶管理

  • 發行項

定義用戶註冊 Microsoft Advertising 的邀請。 邀請會限制帳戶存取權和許可權。

重要事項

傳送邀請時，您可以選擇限制使用者存取直接在客戶底下的廣告客戶子集。 如果 機構階層 現在或未來) 邀請使用者的客戶之下設定 (，而且如果您不限制特定帳戶的存取權，使用者將可存取階層中的所有帳戶。

可能會有多個擱置的邀請傳送至尚未過期的相同電子郵件位址。 這些邀請也可以指定不同的使用者角色，例如，如果您傳送具有不正確使用者角色的邀請，然後傳送具有正確使用者角色的第二個邀請。 收件者可以接受任何邀請，而且可以使用與邀請電子郵件位址不同的認證進行註冊。 Microsoft廣告使用者可以接受邀請給具有相同認證的多位客戶。 如需詳細資訊，請參閱 多使用者認證 技術指南。

您可以依 邀請標識 子搜尋擱置的邀請，並瞭解邀請是否已接受或已過期。 SearchUserInvitations 作業會傳回所有擱置的邀請，無論邀請是否已過期。 接受的邀請不包含在 SearchUserInvitations 回應中。

接受邀請之後，您可以呼叫 GetUsersInfo 和 GetUser 來存取 Microsoft Advertising 使用者詳細數據。 不過，由於收件者可以接受邀請，並以與邀請電子郵件位址不同的認證註冊，因此您無法確定 從UserInvitation 到 User 或 UserInfo 對象的對應。 使用 GetUsersInfo 或 GetUser 傳回的使用者識別碼，您可以呼叫 DeleteUser 視需要移除使用者。 Bing 廣告 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。

具有「廣告行銷活動管理員」等帳戶層級角色的使用者，可以限製為特定帳戶。 具有進階 管理員 等客戶層級角色的使用者可以存取用戶客戶內的所有帳戶，且其存取權不能限制為特定帳戶。

嘗試限制客戶層級使用者角色時，例如嘗試將進階 管理員 限制為特定帳戶時，作業不會失敗，而且使用者會被授與指定客戶內所有帳戶的存取權。

發送： 自選
註冊： 自選		 long 陣列
CustomerId 邀請此使用者管理的客戶識別碼。 AccountIds 元素會決定使用者可以管理哪些客戶帳戶。

發送： 必填
註冊： 唯讀		 長
電子郵件 對應至使用者Microsoft帳戶的電子郵件位址。 位址最多可以包含100個字元。

發送： 必填
註冊： 必填		 string
ExpirationDate 用戶邀請的到期日期和時間。 值為國際標準時間 (UTC)。

使用者邀請的持續時間可能會變更，且目前設定為30天。 您無法設定或更新此值。

發送： 唯讀
註冊： 唯讀		 dateTime
FirstName 使用者的名字。

名字限制為 40 個字元。

發送： 必填
註冊： 必填		 string
標識碼 系統為使用者邀請產生的唯一標識碼。

發送： 唯讀
註冊： 唯讀		 長
LastName 使用者的姓氏。

姓氏限制為 40 個字元。

發送： 必填
註冊： 必填		 string
Lcid 透過電子郵件或郵件傳送信件給使用者時所要使用的地區設定。

預設值為 EnglishUS。

發送： 必填
註冊： 必填		 LCID
RoleId 用戶針對每個客戶或帳戶清單擁有的角色。

可能的值包括下列各項：
16 - 使用者具有 廣告營銷活動管理員 角色。
33 - 使用者具有 匯總工具 角色。
41 - 使用者具有超級 管理員 角色。
100 - 使用者具有 查看器 角色。
203 - 使用者具有 Standard 使用者角色。

如需詳細資訊，請參閱 使用者角色 技術指南。
發送： 必填
註冊： 必填。 角色標識碼必須設定為 41 或 203。		 int

需求

服務： CustomerManagementService.svc v13
Namespace： https://bingads.microsoft.com/Customer/v13/Entities

消費者

SearchUserInvitations
SendUserInvitation
SignupCustomer