The previous Search Ads 360 Reporting API is decommissioned. You can now create your reports using the new Search Ads 360 Reporting API.
Note that the get and getByCustomerId methods in the Search Ads 360 Conversion API are being deprecated in Q3 2025. To continue accessing conversion data, you must create a report using the conversion resource using the new Search Ads 360 Reporting API. See more details here.
Stay organized with collections
Save and categorize content based on your preferences.
Polls for the status of a report request.
Try it now.
The response indicates the status of the report:
If the report is ready for download, the response contains isReportReady: true. The response also contains information such as the number of report files.
If the report is still being worked on, the response contains isReportReady: false.
If DoubleClick Search is unable to complete the report, the response contains the error code 410 Gone and one of the reasons documented in
Response Codes.
Request
HTTP request
GET https://www.googleapis.com/doubleclicksearch/v2/reports/reportId
Parameters
Parameter name
Value
Description
Path parameters
reportId
string
ID of the report request being polled.
Authorization
This request requires authorization with the following scope:
[[["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-10-09 UTC."],[[["Polls for the status of a report request to determine if it's ready for download, still processing, or if an error occurred."],["The response includes an `isReportReady` flag indicating the report status and, if ready, provides details like the number of report files."],["Uses a GET request to the specified endpoint, including the report ID as a path parameter, to retrieve the report status."],["Requires authorization with the `https://www.googleapis.com/auth/doubleclicksearch` scope for access."],["A successful response returns a Reports resource containing information about the requested report."]]],["This outlines polling a report request's status via a GET request to `https://www.googleapis.com/doubleclicksearch/v2/reports/reportId`, requiring authorization. The `reportId` path parameter identifies the report. A successful response indicates `isReportReady: true` if ready, including file information, or `isReportReady: false` if in progress. A 410 Gone error code signifies report failure. The method returns a Reports resource and doesn't use a request body.\n"]]
