通过

UserInvitation 数据对象 - 客户管理

  • 项目

定义用户注册Microsoft广告的邀请。 邀请限制帐户访问权限和权限。

重要

发送邀请后，可以选择限制用户访问客户直接下属的一部分广告客户帐户。 如果现在或将来 () 在邀请用户的客户下设置 代理层次结构 ，并且不限制对特定帐户的访问权限，则用户将有权访问层次结构中的所有帐户。

可以将多个挂起的邀请发送到尚未过期的同一电子邮件地址。 这些邀请也可以指定不同的用户角色，例如，如果使用不正确的用户角色发送了邀请，然后使用正确的用户角色发送了第二个邀请。 收件人可以接受任何邀请，并且可以使用与邀请电子邮件地址不同的凭据进行注册。 Microsoft广告用户可以接受多个客户具有相同凭据的邀请。 有关详细信息，请参阅 多用户凭据 技术指南。

可以按邀请 ID 搜索挂起的 邀请 ，并了解邀请是否已接受或已过期。 SearchUserInvitations 操作将返回所有挂起的邀请，无论它们是否已过期。 接受的邀请不包括在 SearchUserInvitations 响应中。

接受邀请后，可以调用 GetUsersInfo 和 GetUser 来访问Microsoft广告用户详细信息。 但是，由于收件人可以接受邀请并使用不同于邀请电子邮件地址的凭据进行注册，因此无法确定从 UserInvitation 到 User 或 UserInfo 对象的映射。 使用 GetUsersInfo 或 GetUser 返回的用户 ID 后，可以根据需要调用 DeleteUser 以删除该用户。 必应广告 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 元素确定用户可以管理的客户帐户。

发送： 必填
注册： 只读		 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用户角色。

有关详细信息，请参阅 用户角色 技术指南。
发送： 必填
注册： 必填。 角色 ID 必须设置为 41 或 203。		 int

要求

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

使用者

SearchUserInvitations
SendUserInvitation
SignupCustomer