La API anterior de Search Ads 360 Reporting dejó de estar disponible. Ahora puedes crear tus informes con la nueva API de Search Ads 360 Reporting.

Ten en cuenta que los métodos get y getByCustomerId de la API de conversiones de Search Ads 360 dejarán de estar disponibles en el tercer trimestre de 2025. Para seguir accediendo a los datos de conversiones, debes crear un informe con el recurso de conversión mediante la nueva API de Search Ads 360 Reporting. Obtén más detalles aquí.

Se seguirán admitiendo las funciones restantes de la API de conversiones de Search Ads 360.

Se usó la API de Cloud Translation para traducir esta página.

Conversion: updateAvailability

Actualiza la disponibilidad de un lote de actividades de Floodlight en DoubleClick Search. Pruébalo ahora.

Solicitud

Solicitud HTTP

POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability

Autorización

Esta solicitud requiere una autorización con el siguiente alcance:

Alcance
`https://www.googleapis.com/auth/doubleclicksearch`

Para obtener más información, consulta la página de autenticación y autorización.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona los datos con la siguiente estructura:

{
  "availabilities": [
    {
      "agencyId": long,
      "advertiserId": long,
      "customerId": string,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "availabilityTimestamp": unsigned long
    }
  ]
}

Nombre de la propiedad	Valor	Descripción
`availabilities[]`	`list`	La disponibilidad que se solicita.
`availabilities[].agencyId`	`long`	Es el ID de la agencia de DS.
`availabilities[].advertiserId`	`long`	ID del anunciante de DS.
`availabilities[].segmentationType`	`string`	Es el tipo de segmentación para el que se aplica esta disponibilidad (su valor predeterminado es `FLOODLIGHT`). Los valores aceptables son los siguientes: "`FLOODLIGHT`"
`availabilities[].segmentationId`	`long`	Es el identificador de segmentación numérico (por ejemplo, el ID de actividad de Floodlight de DoubleClick Search).
`availabilities[].segmentationName`	`string`	Es el identificador de segmentación simple (por ejemplo, el nombre de la actividad de Floodlight de DoubleClick Search).
`availabilities[].availabilityTimestamp`	`unsigned long`	Es la hora en la que se subieron todas las conversiones, en milisegundos de época UTC.
`availabilities[].customerId`	`string`	ID de cliente nuevo de Search Ads 360 Debe ser una cuenta de subadministrador.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "availabilities": [
    {
      "agencyId": long,
      "advertiserId": long,
      "customerId": string,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "availabilityTimestamp": unsigned long
    }
  ]
}

Nombre de la propiedad	Valor	Descripción
`availabilities[]`	`list`	La disponibilidad que se devuelve
`availabilities[].agencyId`	`long`	Es el ID de la agencia de DS.
`availabilities[].advertiserId`	`long`	ID del anunciante de DS.
`availabilities[].segmentationType`	`string`	Es el tipo de segmentación para el que se aplica esta disponibilidad (su valor predeterminado es `FLOODLIGHT`). Los valores aceptables son los siguientes: "`FLOODLIGHT`"
`availabilities[].segmentationId`	`long`	Es el identificador de segmentación numérico (por ejemplo, el ID de actividad de Floodlight de DoubleClick Search).
`availabilities[].segmentationName`	`string`	Es el identificador de segmentación simple (por ejemplo, el nombre de la actividad de Floodlight de DoubleClick Search).
`availabilities[].availabilityTimestamp`	`unsigned long`	Es la hora en la que se subieron todas las conversiones, en milisegundos de época UTC.
`availabilities[].customerId`	`string`	ID de cliente nuevo de Search Ads 360 Debe ser una cuenta de subadministrador.

Pruébalo

Usa el Explorador de APIs que se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta. También puedes probar la independiente Explorador de aplicaciones.