通过

ClientLink 数据对象 - 客户管理

  • 项目

定义客户端链接对象。 接受客户链接邀请使代理能够管理相应的客户广告客户帐户。 若要发送管理客户广告客户帐户的邀请，请调用 AddClientLinks 操作，并为每个帐户指定一个要管理的客户端链接。

客户端链接没有公共系统标识符。 可以通过 ClientEntityId 和 ManagingCustomerId 标识不同的客户端链接。

提示

有关客户端链接生命周期的详细信息，请参阅 帐户层次结构 技术指南。 有关成为代理机构的详细信息，请参阅 代理合作伙伴的资源。 有关客户角度的详细信息，请参阅 如何让代理管理Microsoft广告帐户。

注意

代理客户在代表客户创建帐户试点 (GetCustomerPilotFeatures 返回 793) 还可以通过 SignupCustomer 服务操作建立广告帐户级客户端链接。 有关详细信息 ，请参阅 SignupCustomer 。

语法

<xs:complexType name="ClientLink" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ClientEntityNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ClientEntityName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="ManagingCustomerNumber" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ManagingCustomerName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Note" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterEmail" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="InviterPhone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="IsBillToClient" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="xs:dateTime" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ClientLinkStatus" />
    <xs:element minOccurs="0" name="SuppressNotification" type="xs:boolean" />
    <xs:element minOccurs="0" name="LastModifiedDateTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="LastModifiedByUserId" type="xs:long" />
    <xs:element minOccurs="0" name="Timestamp" nillable="true" type="xs:base64Binary" />
    <xs:element xmlns:q10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q10:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="CustomerLinkPermission" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

元素

ClientLink 对象具有以下元素：ClientEntityId、ClientEntityName、ClientEntityNumber、CustomerLinkPermission、ForwardCompatibilityMap、InviterEmail、InviterName、InviterPhone、IsBillToClient、LastModifiedByUserId、LastModifiedDateTime、ManagingCustomerId、ManagingCustomerName、ManagingCustomerNumber、 Name、Note、StartDate、Status、SuppressNotification、Timestamp、Type。

元素 说明 数据类型
ClientEntityId 要管理的客户广告客户帐户或客户客户的标识符

Type 元素确定链接是指向客户广告客户帐户还是客户客户。

加： 必填。 需要 ClientEntityId 或 ClientEntityNumber ，但同时指定这两者将导致操作失败。
更新： 只读和必需。		 long
ClientEntityName 要管理的客户广告客户帐户或客户客户的名称

Type 元素确定链接是指向客户广告客户帐户还是客户客户。

加： 只读
更新： 只读		 string
ClientEntityNumber 要管理的客户广告客户帐户或客户客户的数量

Type 元素确定链接是指向客户广告客户帐户还是客户客户。

加： 必填。 需要 ClientEntityId 或 ClientEntityNumber ，但同时指定这两者将导致操作失败。
更新： 只读和必需。		 string
CustomerLinkPermission 确定用户对帐户的访问是否受客户层次结构（即客户级客户端链接）的限制。

仅当 Type 设置为 CustomerLink 时，此元素才适用。 在这种情况下，可能的值包括“管理”和“Standard”。 否则，此字段应为 nil 或空。

如果此字段设置为“管理”，则用户可以通过管理客户链接访问 ClientEntityId。

如果此字段设置为“Standard”，则用户可以通过Standard客户链接访问 ClientEntityId。

ClientEntityId 是客户链接层次结构的一部分，用户可以通过该层次结构访问其下的其他客户。

有关详细信息，请参阅 用户角色 技术指南。

加： 自选
更新： 只读		 string
ForwardCompatibilityMap 用于向前兼容性的键和值字符串列表，以避免在当前 API 版本中添加新元素时发生重大更改。

将来的版本中将在此处记录向前兼容性更改。 目前没有 对 ClientLink 对象进行向前兼容性更改。		 KeyValuePairOfstringstring 数组
InviterEmail 创建客户端链接请求的用户的电子邮件。

此值不需要与已存储在当前经过身份验证的用户Microsoft广告中的电子邮件相同，也不需要用于修改。

如果未指定，则服务会将此值设置为已存储在当前经过身份验证的用户Microsoft广告中的电子邮件。

加： 自选
更新： 只读		 string
InviterName 创建客户端链接请求的用户的父客户的名称。

此值不需要与已存储在 Microsoft Advertising 中的客户名称相同，也不需要对其进行修改。

如果未指定，服务会将此值设置为已存储在当前经过身份验证的用户Microsoft广告中的父客户名称。

加： 自选
更新： 只读		 string
InviterPhone 创建客户端链接请求的用户的电话号码。

此值不需要与当前经过身份验证的用户存储在Microsoft广告中的电话号码相同，也不需要用于修改。

如果未指定，则服务会将此值设置为当前经过身份验证的用户的Microsoft广告中已存储的电话号码。

加： 自选
更新： 只读		 string
IsBillToClient 确定客户广告客户帐户的所有者或管理客户是否负责计费付款。

此元素仅适用于广告客户帐户客户链接，不适用于客户链接。 必须设置客户广告客户帐户以用于付款后计费。 代理不支持管理预付费帐户。 如果设置为 true，则客户端负责计费。 如果设置为 false，则管理客户负责计费。

加： 广告客户帐户链接是必需的;不适用于客户链接。
更新： 只读		 boolean
LastModifiedByUserId 要更新客户端链接信息的最后一个用户的标识符。

加： 只读
更新： 只读		 long
LastModifiedDateTime 上次更新客户端链接的日期和时间。 该值以协调世界时 (UTC) 表示。

日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。

加： 只读
更新： 只读		 dateTime
ManagingCustomerId 管理或请求管理客户广告客户帐户的客户标识符。

加： 必填。 需要 ManagementCustomerId 或 ManagingCustomerNumber ，但同时指定这两者将导致操作失败。
更新： 只读和必需		 long
ManagingCustomerName 管理或请求管理客户广告客户帐户的客户的名称。

加： 只读
更新： 只读		 string
ManagingCustomerNumber 管理或请求管理客户广告客户帐户的客户数。

加： 必填。 需要 ManagementCustomerId 或 ManagingCustomerNumber ，但同时指定这两者将导致操作失败。
更新： 只读和必需		 string
名称 可用于引用此客户端链接的友好名称。

名称最多可以包含 40 个字符。

如果未指定任何名称，则会提供默认名称。 与用户的其他客户端链接相比，名称不需要是唯一的。

加： 自选
更新： 只读		 string
注意 来自请求者的可选消息，提供有关客户端链接邀请的上下文和详细信息。

加： 自选
更新： 自选。 如果未为更新设置任何值，则不会更改此设置。		 string
StartDate 状态更新的日期。 对于接受的链接请求，状态将在此日期转换为“活动”，对于取消链接请求，状态将在此日期转换为“非活动”。

如果未指定，此值将设置为当前日期和时间。

加： 自选
更新： 只读		 dateTime
状态 确定客户端链接的生命周期状态，例如客户端链接是已接受还是被拒绝。

添加客户端链接时，无法指定此元素，并且服务会将有效状态设置为 LinkPending。

加： 只读
更新： 必填		 ClientLinkStatus
SuppressNotification 确定是否将客户链接邀请的电子邮件通知发送给客户广告客户帐户的主要用户。

如果设置为 true，则客户端不会收到电子邮件，否则，由于默认值为 false，客户端将收到电子邮件通知。

加： 自选
更新： 只读		 boolean
Timestamp 保留供以后使用。 base64Binary
类型 确定链接是指向客户广告客户帐户还是客户客户。

可能的值为 AccountLink 和 CustomerLink。 如果此元素为空或设置为 AccountLink， 则 ClientEntityId、 ClientEntityName 和 ClientEntityNumber 表示客户广告客户帐户。 如果此元素设置为 CustomerLink， 则 ClientEntityId、 ClientEntityName 和 ClientEntityNumber 表示客户端客户。

加： 自选。 如果未设置此元素，服务将尝试创建广告客户帐户客户端链接。
更新： 只读		 string

要求

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

使用者

AddClientLinks
SearchClientLinks
UpdateClientLinks