Method: customers.customerManagerLinks.mutate

更新与客户经理的关联。返回操作状态。

抛出的错误列表：AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError ManagerLinkError MutateError QuotaError RequestError

HTTP 请求

POST https://googleads.googleapis.com/v14/customers/{customerId}/customerManagerLinks:mutate

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。要修改其客户经理关联的客户的 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "operations": [
    {
      object (CustomerManagerLinkOperation)
    }
  ],
  "validateOnly": boolean
}
字段
operations[]

object (CustomerManagerLinkOperation)

必需。要针对各个客户经理关联执行的操作的列表。
validateOnly

boolean

如果为 true，则对请求进行验证，但不会执行该请求。系统只会返回错误，不会返回结果。

响应正文

CustomerManagerLink mutate 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "results": [
    {
      object (MutateCustomerManagerLinkResult)
    }
  ]
}
字段
results[]

object (MutateCustomerManagerLinkResult)

一个结果，用于标识受 mutate 请求影响的资源。

授权范围

需要以下 OAuth 作用域：

  • https://www.googleapis.com/auth/adwords

有关详情，请参阅 OAuth 2.0 概览。

CustomerManagerLinkOperation

更新 CustomerManagerLink 的状态。可执行的操作如下：1. 将状态设为“ACTIVE”的更新操作接受一个待处理的邀请。2. 状态为“REFUSED”的更新操作会拒绝待处理的邀请。3. 状态为 INACTIVE 的更新操作会终止与管理器的关联。

JSON 表示法 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (CustomerManagerLink)
  }
  // End of list of possible types for union field operation.
}
字段
updateMask

string (FieldMask format)

用于确定更新中修改哪些资源字段的 FieldMask。

这是以逗号分隔的完全限定字段名称列表。示例："user.displayName,photo"。
联合字段 operation。mutate 操作。operation 只能是下列其中一项：
update

object (CustomerManagerLink)

更新操作：链接应具有有效的资源名称。

MutateCustomerManagerLinkResult

客户经理关联结果发生变化。

JSON 表示法 
{
  "resourceName": string
}
字段
resourceName

string

如果操作成功，系统会返回此错误代码。