La API anterior de Search Ads 360 Reporting dejará de estar disponible y se retirará el 30 de junio de 2024. Ten en cuenta que la API de conversiones de Search Ads 360 no se ve afectada y seguirá siendo compatible. Todo el desarrollo de informes nuevo debe usar la nueva API de Search Ads 360 Reporting.

A partir de abril de 2024, se mostrará un error supportedApiVersion cuando se solicite un informe. Consulte los detalles aquí.

También te recomendamos que migres todas las implementaciones existentes de Search Ads 360 a la nueva API. Consulta la introducción y la guía de migración de la nueva API de Search Ads 360 Reporting para obtener más información.

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.