UserInvitation 數據物件 - 客戶管理
定義用戶註冊 Microsoft Advertising 的邀請。 邀請會限制帳戶存取權和許可權。
重要事項
傳送邀請時，您可以選擇限制使用者存取直接在客戶底下的廣告客戶子集。 如果 機構階層 現在或未來) 邀請使用者的客戶之下設定 (，而且如果您不限制特定帳戶的存取權，使用者將可存取階層中的所有帳戶。
可能會有多個擱置的邀請傳送至尚未過期的相同電子郵件位址。 這些邀請也可以指定不同的使用者角色，例如，如果您傳送具有不正確使用者角色的邀請，然後傳送具有正確使用者角色的第二個邀請。 收件者可以接受任何邀請，而且可以使用與邀請電子郵件位址不同的認證進行註冊。 Microsoft Advertising 用戶可以接受邀請給具有相同認證的多位客戶。 如需詳細資訊，請參閱 多使用者認證 技術指南。
您可以依 邀請標識 子搜尋擱置的邀請，並瞭解邀請是否已接受或已過期。 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 |
| Id | 系統為使用者邀請產生的唯一標識碼。 發送： 唯讀 註冊： 唯讀 |
長 |
| LastName | 使用者的姓氏。 姓氏限制為 40 個字元。 發送： 必填 註冊： 必填 |
string |
| Lcid | 透過電子郵件或郵件傳送信件給使用者時所要使用的地區設定。 預設值為 EnglishUS。 發送： 必填 註冊： 必填 |
LCID |
| RoleId | 用戶針對每個客戶或帳戶清單擁有的角色。 可能的值包括下列各項： 16 - 使用者具有 廣告營銷活動管理員 角色。 33 - 使用者具有 匯總工具 角色。 41 - 使用者具有超級 管理員 角色。 100 - 使用者具有 查看器 角色。 203 - 使用者具有 標準使用者 角色。 如需詳細資訊，請參閱 使用者角色 技術指南。 發送： 必填 註冊： 必填。 角色標識碼必須設定為 41 或 203。 |
int |
需求
服務： CustomerManagementService.svc v13
命名空間： https://bingads.microsoft.com/Customer/v13/Entities