Response Codes in the Search Ads 360 API

AI-generated Key Takeaways

• Search Ads 360 API returns a 200 HTTP status code for successful requests and a status code between 400 and 499 for validation failures.

• If a valid report request cannot be generated, the API returns a 410 status code with a specific reason, such as the report being too large, rate limit exceeded, or internal server error.

• For report generation failures, recommended actions include requesting smaller reports, checking client request frequency, contacting support for quota increases, or reviewing report configurations.

• The API provides detailed descriptions and recommended actions for each type of report generation failure, helping users troubleshoot and resolve issues effectively.

• For other errors, refer to the Standard Error Responses documentation for guidance.

If a request to the Search Ads 360 API is successful, the API returns a 200 HTTP status code along with the requested data in the body of the response.

If a request fails to validate, the API returns an HTTP status code between 400 and 499 along with a description of the validation error.

If you send a valid Report.get() request but Search Ads 360 is unable to generate a report, the API returns one of the HTTP status codes described below.

Code	Reason	Description	Recommended action
410	reportUnavailableRequestTooLarge	The report is no longer being processed because the report is too large.	Request multiple smaller reports instead. For example, break a single advertiser report into multiple engine account reports. Or break a year-long report into 12 month long reports.
410	reportUnavailableRateLimitExceeded	The report is no longer being processed because too many reports were requested by the developer project in a short amount of time.	Make sure your client isn't sending requests more frequently than you intend. If your client is performing as expected, contact Search Ads 360 customer support. Include your developer project ID, and the Code and Reason from this table row (and not the one below).
410	reportUnavailableQuotaExceeded	The report is no longer being processed because too much data has been requested by the developer project today.	Make sure your client isn't sending larger requests than you intend. You can keep track of your quota usage in Google Cloud Console. If your client is performing as expected, contact Search Ads 360 customer support and ask for a quota increase. Include your developer project ID, and the Code and Reason from this table row (and not the one above). Also see Pricing and Usage Limits.
410	reportUnavailableInternalServerError	Search Ads 360 is unable to return or generate the report for some unexpected reason.	Contact Search Ads 360 customer support. Include your report ID.
410	reportUnavailableRequestError	Even though the request passed validation, Search Ads 360 cannot generate the requested report because it contains an invalid combination of columns, filters, and segmentations.	Contact Search Ads 360 customer support. Include your report ID.
400	unsupportedApiVersion	Version not supported.	Migrate to the Search Ads 360 Reporting API.

For all other types of errors, the API returns Standard Error Responses.