Method: customers.customerUserAccesses.mutate

Atualiza e remove a permissão de um usuário em um determinado cliente. Os status da operação são retornados.

Lista de erros gerados: AuthenticationError AuthorizationError CustomerUserAccessError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. ID do cliente que está sendo modificado.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "operation": {
    object (CustomerUserAccessOperation)
  }
}
Campos
operation

object (CustomerUserAccessOperation)

Obrigatório. A operação a ser realizada no cliente.

Corpo da resposta

Mensagem de resposta para mudança do acesso do usuário do cliente.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "result": {
    object (MutateCustomerUserAccessResult)
  }
}
Campos
result

object (MutateCustomerUserAccessResult)

Resultado para a modificação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

CustomerUserAccessOperation

Uma única operação (atualizar, remover) no acesso do usuário do cliente.

Representação 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.
}
Campos
updateMask

string (FieldMask format)

FieldMask que determina quais campos de recursos são modificados em uma atualização.

Esta é uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".
Campo de união operation. A operação de mutação. operation pode ser apenas de um dos tipos a seguir:
update

object (CustomerUserAccess)

Operação de atualização: o acesso do usuário do cliente precisa ter um nome de recurso válido.
remove

string

Operação de remoção: é esperado um nome de recurso para o acesso removido, neste formato:

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

MutateCustomerUserAccessResult

Resultado para a mutação do acesso do usuário do cliente.

Representação JSON 
{
  "resourceName": string
}
Campos
resourceName

string

É retornado para operações bem-sucedidas.