Conversion: updateAvailability

  • Updates the availability status for a batch of floodlight activities in DoubleClick Search.

  • Requires authorization with the https://www.googleapis.com/auth/doubleclicksearch scope.

  • The request body includes an array of availabilities with details like agencyId, advertiserId, segmentation details, and availability timestamp.

  • The response returns an array of availabilities mirroring the request structure, confirming the updated status.

Updates the availabilities of a batch of floodlight activities in DoubleClick Search. Try it now.

Request

HTTP request

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

Authorization

This request requires authorization with the following scope:

Scope
https://www.googleapis.com/auth/doubleclicksearch

For more information, see the authentication and authorization page.

Request body

In the request body, supply data with the following structure:

{
  "availabilities": [
    {
      "agencyId": long,
      "advertiserId": long,
      "customerId": string,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "availabilityTimestamp": unsigned long
    }
  ]
}
Property name Value Description Notes
availabilities[] list The availabilities being requested.
availabilities[].agencyId long DS agency ID.
availabilities[].advertiserId long DS advertiser ID.
availabilities[].segmentationType string The segmentation type that this availability is for (its default value is FLOODLIGHT).

Acceptable values are:
  • "FLOODLIGHT"
availabilities[].segmentationId long The numeric segmentation identifier (for example, DoubleClick Search Floodlight activity ID).
availabilities[].segmentationName string The friendly segmentation identifier (for example, DoubleClick Search Floodlight activity name).
availabilities[].availabilityTimestamp unsigned long The time by which all conversions have been uploaded, in epoch millis UTC.
availabilities[].customerId string New Search Ads 360 customer ID. This must be a sub-manager account.

Response

If successful, this method returns a response body with the following structure:

{
  "availabilities": [
    {
      "agencyId": long,
      "advertiserId": long,
      "customerId": string,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "availabilityTimestamp": unsigned long
    }
  ]
}
Property name Value Description Notes
availabilities[] list The availabilities being returned.
availabilities[].agencyId long DS agency ID.
availabilities[].advertiserId long DS advertiser ID.
availabilities[].segmentationType string The segmentation type that this availability is for (its default value is FLOODLIGHT).

Acceptable values are:
  • "FLOODLIGHT"
availabilities[].segmentationId long The numeric segmentation identifier (for example, DoubleClick Search Floodlight activity ID).
availabilities[].segmentationName string The friendly segmentation identifier (for example, DoubleClick Search Floodlight activity name).
availabilities[].availabilityTimestamp unsigned long The time by which all conversions have been uploaded, in epoch millis UTC.
availabilities[].customerId string New Search Ads 360 customer ID. This must be a sub-manager account.

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.