Method: outages.list

  • This API endpoint allows you to retrieve a list of Ads Data Hub outages within the last 130 days, sorted by outage start timestamp in descending order.

  • You can control the number of outages returned and navigate through paginated results using query parameters like pageSize and pageToken.

  • The response provides a list of outage objects and a token for retrieving subsequent pages, if available.

  • To utilize this endpoint, you need to authorize your request with the https://www.googleapis.com/auth/adsdatahub OAuth scope.

Lists the outages in descending order of outage start timestamp, and the look back window is 130 days.

HTTP request

GET https://adsdatahub.googleapis.com/v1/outages

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
pageSize

integer

Maximum number of items to return. If 0, The server will determine the number of outages to return.
pageToken

string

Page token, returned by a previous call, used to request the next page of results, if any.

Request body

The request body must be empty.

Response body

Response to a outages.list request, contains the outages.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "outages": [
    {
      object (Outage)
    }
  ],
  "nextPageToken": string
}
Fields
outages[]

object (Outage)

The outages within the look back window
nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adsdatahub