Method: customers.customInterests.mutate

Crea o actualiza intereses personalizados. Se muestran los estados de las operaciones.

Lista de errores generados: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

Solicitud HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/customInterests: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 cuyos intereses personalizados se modifican.

Cuerpo de la solicitud

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

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

object (CustomInterestOperation)

Obligatorio. Es la lista de operaciones que se deben realizar en intereses personalizados 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 el caso del interés personalizado mutate.

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

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

object (MutateCustomInterestResult)

Todos los resultados para la función {i>mutate<i}.

Alcances 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.

CustomInterestOperation

Una sola operación (crear, actualizar) en un interés personalizado.

Representación JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomInterest)
  },
  "update": {
    object (CustomInterest)
  }
  // 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 de mutación Las direcciones (operation) solo pueden ser una de las siguientes opciones:
create

object (CustomInterest)

Operación de creación: No se espera ningún nombre de recurso para el nuevo interés personalizado.
update

object (CustomInterest)

Operación de actualización: Se espera que el interés personalizado tenga un nombre de recurso válido.

MutateCustomInterestResult

Es el resultado del cambio de interés personalizado.

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

string

Se muestra para operaciones correctas.