Method: customers.accountLinks.mutate

Crea o quita una vinculación de cuenta. A partir de la versión 5, la creación no es compatible con AccountLinkService.MutateAccountLink. En su lugar, usa AccountLinkService.CreateAccountLink.

Lista de errores generados: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

Solicitud HTTP

POST https://googleads.googleapis.com/v19/customers/{customerId}/accountLinks:mutate

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Es obligatorio. El ID del cliente que se modificará.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "operation": {
    object (AccountLinkOperation)
  },
  "partialFailure": boolean,
  "validateOnly": boolean
}
Campos
operation

object (AccountLinkOperation)

Es obligatorio. Es la operación que se realizará en el vínculo.
partialFailure

boolean

Si es verdadero, se llevarán a cabo las operaciones correctas y las operaciones no válidas mostrarán errores. Si es falso, todas las operaciones se llevarán a cabo en una sola transacción solo si todas son válidas. El valor predeterminado es falso.
validateOnly

boolean

Si es verdadero, la solicitud se valida, pero no se ejecuta. Solo se devuelven errores, no resultados.

Cuerpo de la respuesta

Mensaje de respuesta para la mutación de vinculación de cuentas.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "result": {
    object (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
Campos
result

object (MutateAccountLinkResult)

Es el resultado de la mutación.
partialFailureError

object (Status)

Errores relacionados con fallas de operación en el modo de falla parcial. Solo se muestra cuando partialFailure = true y todos los errores se producen dentro de las operaciones. Si se produce algún error fuera de las operaciones (por ejemplo, errores de autenticación), devolvemos un error a nivel de la RPC.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

AccountLinkOperation

Una sola actualización en una vinculación de cuentas.

Representación 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 qué campos de recursos se modifican en una actualización.

Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
Campo de unión operation. La operación que se realizará. Las direcciones (operation) solo pueden ser una de las siguientes opciones:
update

object (AccountLink)

Operación de actualización: Se espera que el vínculo de la cuenta tenga un nombre de recurso válido.
remove

string

Operación de eliminación: Se espera un nombre de recurso para el vínculo de la cuenta que se quitará, en este formato:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

Se muta el resultado de la vinculación de la cuenta.

Representación JSON 
{
  "resourceName": string
}
Campos
resourceName

string

Se muestra para operaciones correctas.