This is legacy documentation, and may not be complete. To see the latest documentation, if you are a marketer, refer to the Marketers site. If you are a measurement partner, refer to the Measurement Partners site.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eThis 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.\u003c/p\u003e\n"],["\u003cp\u003eYou can control the number of outages returned and navigate through paginated results using query parameters like \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a list of outage objects and a token for retrieving subsequent pages, if available.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize this endpoint, you need to authorize your request with the \u003ccode\u003ehttps://www.googleapis.com/auth/adsdatahub\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["The system retrieves outages data using a `GET` request to `https://adsdatahub.googleapis.com/v1/outages`. It accepts optional `pageSize` and `pageToken` query parameters for pagination. The request body must be empty. The response, in JSON format, includes an array of `outages` objects and an optional `nextPageToken` for subsequent pages. Results are sorted by descending outage start time, within a 130-day look-back window. Authorization requires the `https://www.googleapis.com/auth/adsdatahub` OAuth scope.\n"],null,["# Method: outages.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListOutagesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nLists the outages in descending order of outage start timestamp, and the look back window is 130 days.\n\n### HTTP request\n\n`GET https://adsdatahub.googleapis.com/v1/outages`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Maximum number of items to return. If 0, The server will determine the number of outages to return. |\n| `pageToken` | `string` Page token, returned by a previous call, used to request the next page of results, if any. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse to a outages.list request, contains the outages.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------|\n| ``` { \"outages\": [ { object (/ads-data-hub/reference/rest/v1/outages#Outage) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `outages[]` | `object (`[Outage](/ads-data-hub/reference/rest/v1/outages#Outage)`)` The outages within the look back window |\n| `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. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/adsdatahub`"]]