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 .
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: