Method: customers.customerUserAccesses.mutate

Actualizaciones: Quita el permiso de un usuario en un cliente determinado. Se muestran los estados de la operación.

Lista de errores arrojados: AuthenticationError AuthorizationError CustomerUserAccessError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

Solicitud HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/customerUserAccesses:mutate

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

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. El ID del cliente que se modifica.

Cuerpo de la solicitud

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

Representación JSON 
{
  "operation": {
    object (CustomerUserAccessOperation)
  }
}
Campos
operation

object (CustomerUserAccessOperation)

Obligatorio. La operación que se realizará en el cliente

Cuerpo de la respuesta

Mensaje de respuesta para la modificación del acceso de usuario del cliente.

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

Representación JSON 
{
  "result": {
    object (MutateCustomerUserAccessResult)
  }
}
Campos
result

object (MutateCustomerUserAccessResult)

Resultado de la función {i>mutate<i}.

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.

CustomerUserAccessOperation

Una sola operación (actualizar, quitar) con el acceso de usuario del cliente.

Representación JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (CustomerUserAccess)
  },
  "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 completamente calificados. Ejemplo: "user.displayName,photo".
Campo de unión operation. La operación {i>mutate<i}. Las direcciones (operation) solo pueden ser una de las siguientes opciones:
update

object (CustomerUserAccess)

Operación de actualización: Se espera que el acceso de usuario del cliente tenga un nombre de recurso válido.
remove

string

Operación de eliminación: Se espera un nombre de recurso para el acceso quitado, en este formato:

customers/{customerId}/customerUserAccesses/{CustomerUserAccess.user_id}

MutateCustomerUserAccessResult

El resultado del cambio de acceso de usuario del cliente.

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

string

Se muestra para operaciones exitosas.