Method: customers.accountLinks.mutate

Cria ou remove uma vinculação de conta. Na V5, não é possível criar usando 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/v19/customers/{customerId}/accountLinks:mutate

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

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O 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 realizada no link.
partialFailure

boolean

Se for "true", as operações bem-sucedidas serão realizadas e as operações inválidas vão retornar erros. Se for falso, todas as operações serão realizadas em uma transação somente se forem válidas. O padrão é false
validateOnly

boolean

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

Corpo da resposta

Mensagem de resposta para a modificação da vinculação 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 da modificação.
partialFailureError

object (Status)

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

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

AccountLinkOperation

Uma única atualização em uma vinculação de conta.

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.

É 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 a vinculação da conta a ser removida, neste formato:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

O resultado da modificação da vinculação da conta.

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

string

É retornado para operações bem-sucedidas.