Method: customers.customerManagerLinks.mutate

Atualiza os links do gerente de clientes. Os status da operação são retornados.

Lista de erros gerados: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError ManagerLinkError MutateError QuotaError RequestError

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente cujos links de gerente de clientes estão sendo modificados.

Corpo da solicitação

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

Representação JSON 
{
  "operations": [
    {
      object (CustomerManagerLinkOperation)
    }
  ],
  "validateOnly": boolean
}
Campos
operations[]

object (CustomerManagerLinkOperation)

Obrigatório. A lista de operações a serem realizadas em links de gerentes de clientes individuais.
validateOnly

boolean

Se verdadeiro, a solicitação é validada, mas não executada. Somente erros são retornados, não resultados.

Corpo da resposta

Mensagem de resposta para uma mutate do CustomerManagerLink.

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

Representação JSON 
{
  "results": [
    {
      object (MutateCustomerManagerLinkResult)
    }
  ]
}
Campos
results[]

object (MutateCustomerManagerLinkResult)

Um resultado que identifica o recurso afetado pela solicitação de mutaçã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.

CustomerManagerLinkOperation

Atualiza o status de um CustomerManagerLink. As seguintes ações são possíveis: 1. A operação de atualização com status ACTIVE aceita um convite pendente. 2. A operação de atualização com o status RECUSADA recusa um convite pendente. 3. A operação de atualização com status INACTIVE encerra a vinculação com o administrador.

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

string (FieldMask format)

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

É 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 (CustomerManagerLink)

Operação de atualização: o link precisa ter um nome de recurso válido.

MutateCustomerManagerLinkResult

Resultado da modificação do link do gerente de clientes.

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

string

Retornado para operações bem-sucedidas.