Method: customers.customerManagerLinks.mutate

Actualiza las vinculaciones del administrador de clientes. Se muestran los estados de las operaciones.

Lista de errores arrojados: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError ManagerLinkError MutateError QuotaError RequestError

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. Es el ID del cliente cuyos vínculos de administrador de clientes se están modificando.

Cuerpo de la solicitud

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

Representación JSON 
{
  "operations": [
    {
      object (CustomerManagerLinkOperation)
    }
  ],
  "validateOnly": boolean
}
Campos
operations[]

object (CustomerManagerLinkOperation)

Obligatorio. La lista de operaciones que se deben realizar en las vinculaciones de los administradores de clientes individuales.
validateOnly

boolean

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

Cuerpo de la respuesta

Mensaje de respuesta para una mutación de CustomerManagerLink.

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

Representación JSON 
{
  "results": [
    {
      object (MutateCustomerManagerLinkResult)
    }
  ]
}
Campos
results[]

object (MutateCustomerManagerLinkResult)

Un resultado que identifica el recurso afectado por la solicitud de mutación.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Descripción general de OAuth 2.0.

CustomerManagerLinkOperation

Actualiza el estado de un CustomerManagerLink. Se pueden realizar las siguientes acciones: 1. La operación de actualización con el estado ACTIVE acepta una invitación pendiente. 2. La operación de actualización con el estado REFused rechaza una invitación pendiente. 3. La operación de actualización con el estado INACTIVE finaliza la vinculación con el administrador.

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

Se trata de una lista separada por comas de los nombres de campos completamente calificados. Ejemplo: "user.displayName,photo".
Campo de unión operation. La operación de mutación. Las direcciones (operation) solo pueden ser una de las siguientes opciones:
update

object (CustomerManagerLink)

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

MutateCustomerManagerLinkResult

Cambiar el resultado de la vinculación del administrador de clientes

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

string

Se muestra para operaciones exitosas.