CustomerRole 数据对象 - 客户管理

定义代表特定客户行事的人员的帐户访问权限。

一个人可以使用同一登录凭据访问多个客户的帐户，并且可以通过 GetUser 操作为一个人返回多个 CustomerRole 对象。 例如，如果user@contoso.com受邀加入 Customer 123 并且用户还有权管理 Customer 234 下的链接帐户，则会返回两个 CustomerRole 对象。

单独来说，用户对给定 CustomerRole 的 CustomerId、AccountId 和LinkedAccountIds 具有相同的角色;但是，如果用户具有多个客户角色，则作为一个整体采取有效权限取决于 GetUser 返回的完整 CustomerRoles 集。 下面提供了几个示例。

提示

请参阅 帐户层次结构和用户权限 指南，了解客户角色的概述以及示例。

语法

XML

<xs:complexType name="CustomerRole" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="RoleId" type="xs:int" />
    <xs:element minOccurs="0" name="CustomerId" type="xs:long" />
    <xs:element xmlns:q7="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="AccountIds" nillable="true" type="q7:ArrayOflong" />
    <xs:element xmlns:q8="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="LinkedAccountIds" nillable="true" type="q8:ArrayOflong" />
    <xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

JSON

{
  "AccountIds": [
    "LongValueHere"
  ],
  "CustomerId": "LongValueHere",
  "CustomerLinkPermission": "ValueHere",
  "LinkedAccountIds": [
    "LongValueHere"
  ],
  "RoleId": IntValueHere
}

元素

CustomerRole 对象具有以下元素：AccountIds、CustomerId、CustomerLinkPermission、LinkedAccountIds、RoleId。

元素	说明	数据类型
AccountIds	用户可以在客户中访问的帐户列表。 如果用户具有 CID 级别的访问，则不会返回 AccountID 。 对于帐户级别访问， AccountID 将在 GetUser API 的 CustomerRole 对象中返回。	long 数组
CustomerId	用户已注册或具有某种 帐户层次结构 关系的客户的标识符。	long
CustomerLinkPermission	确定用户对帐户的访问是否受客户层次结构（即客户级客户端链接）的限制。 可能的值包括“Administrative”、“Standard”和“LinkedEntityOnly”。 此外，此字段可能为零或空。 如果此字段为 nil 或空，则用户直接在 CustomerId 上注册。 如果此字段设置为“管理”，则用户可以通过管理客户链接访问 CustomerId。 如果此字段设置为“Standard”，则用户可以通过Standard客户链接访问 CustomerId。 如果此字段设置为“LinkedEntityOnly”，则用户直接在 CustomerId 上注册，但无法访问其广告客户帐户。 CustomerId 是客户链接层次结构的一部分，用户可以通过该层次结构访问其下的其他客户。 有关详细信息，请参阅 用户角色 技术指南。	string
LinkedAccountIds	用户可以代表另一个客户通过 CustomerId 作为代理访问的链接帐户列表。 如果此元素为 nil，则用户无权通过 CustomerId 访问单独链接的广告客户帐户。 用户可能有权访问其他链接客户中的广告客户帐户，因此请务必考虑 GetUser 返回的所有 CustomerRoles。 请注意，通过 SignupCustomer 创建为聚合器的帐户也将在此元素中返回。 可以通过 DeleteAccount 删除聚合帐户，但不能通过 UpdateClientLinks 取消链接这些帐户。 调用 SearchClientLinks 操作以帮助确定哪些帐户可以取消链接。	long 数组
RoleId	用户通过 CustomerId 访问广告客户帐户时所扮演的角色。 可能的值包括： 16 - 用户具有 广告客户市场活动经理 角色。 33 - 用户具有 聚合者 角色。 41 - 用户具有超级管理员角色。 100 - 用户具有 “查看者 ”角色。 203 - 用户具有Standard用户角色。 有关详细信息，请参阅 用户角色 技术指南。	int

要求

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

使用者

GetUser