Method: outages.list

  • This API endpoint lists outages in descending order of start timestamp with a 130-day look back window.

  • The request is an HTTP GET to https://adsdatahub.googleapis.com/v1/outages and requires an empty request body.

  • Query parameters can be used to control pagination with pageSize and pageToken.

  • The response body contains a list of outages and a nextPageToken for retrieving additional results.

  • Authorization requires 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