Method: customers.accountLinks.mutate

Cria ou remove a vinculação de uma conta. Na V5, não há suporte para criação por meio de AccountLinkService.mutateAccountLink. Use AccountLinkService.CreateAccountLink.

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

Solicitação HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/accountLinks: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 (AccountLinkOperation)
  },
  "partialFailure": boolean,
  "validateOnly": boolean
}
Campos
operation

object (AccountLinkOperation)

Obrigatório. A operação a ser executada na vinculação.
partialFailure

boolean

Se verdadeiro, as operações bem-sucedidas serão realizadas e as operações inválidas retornarão erros. Se for falso, todas as operações serão realizadas em uma transação apenas se todas forem válidas. O padrão é false
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 a modificação do link da conta.

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

Representação JSON 
{
  "result": {
    object (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
Campos
result

object (MutateAccountLinkResult)

Resultado para a modificação.
partialFailureError

object (Status)

Erros relacionados a falhas de operação no modo de falha parcial. Retornado somente quando partialFailure = true e todos os erros ocorrem dentro das operações. Se ocorrer algum erro fora das operações (por exemplo, erros de autenticação), vamos retornar um erro no nível da RPC.

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.

AccountLinkOperation

Uma única atualização na vinculação de contas.

Representação JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (AccountLink)
  },
  "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 a ser executada. operation pode ser apenas de um dos tipos a seguir:
update

object (AccountLink)

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

string

Operação de remoção: é esperado um nome de recurso para o link da conta a ser removido, neste formato:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

Resultado para a modificação do link da conta.

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

string

É retornado para operações bem-sucedidas.