Method: customers.customerUserAccesses.mutate

更新，移除用户对给定客户的权限。返回操作状态。

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

HTTP 请求

POST https://googleads.googleapis.com/v15/customers/{customerId}/customerUserAccesses:mutate

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。要修改的客户的 ID。

请求正文

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

JSON 表示法 
{
  "operation": {
    object (CustomerUserAccessOperation)
  }
}
字段
operation

object (CustomerUserAccessOperation)

必需。要对客户执行的操作

响应正文

客户用户访问权限变更的响应消息。

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

JSON 表示法 
{
  "result": {
    object (MutateCustomerUserAccessResult)
  }
}
字段
result

object (MutateCustomerUserAccessResult)

mutate 的结果。

授权范围

需要以下 OAuth 作用域：

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

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

CustomerUserAccessOperation

对客户用户访问权限仅执行一项操作（更新、移除）。

JSON 表示法 
{
  "updateMask": string,

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

string (FieldMask format)

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

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

object (CustomerUserAccess)

更新操作：客户用户访问权限应具有有效的资源名称。
remove

string

移除操作：已移除访问权限的资源名称应采用以下格式：

customers/{customerId}/customerUserAccesses/{CustomerUserAccess.user_id}

MutateCustomerUserAccessResult

客户用户访问权限的结果发生变化。

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

string

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