Search Ads 360 API 中的响应代码
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
如果对 Search Ads 360 API 的请求成功，该 API 会在响应正文中随请求的数据一并返回 200 HTTP 状态代码。
如果请求验证失败，该 API 会返回介于 400 和 499 之间的 HTTP 状态代码，以及验证错误的说明。
如果您发送有效的 Report.get() 请求，但 Search Ads 360 无法生成报告，该 API 会返回下述某个 HTTP 状态代码。
| 代码 |
原因 |
说明 |
建议采取的措施 |
410 |
reportUnavailableRequestTooLarge |
由于报告过大，系统无法继续处理。 |
请改为请求多个较小的报告。例如，将单个广告客户报告拆分为多个引擎账号报告。或者将一年的报告拆分为 12 个月的报告。 |
410 |
reportUnavailableRateLimitExceeded |
由于开发者项目在短时间内请求了太多报告，因此系统不再处理该报告。 |
确保您的客户端发送请求的频率没有超出您的预期。
如果客户的效果符合预期，请与 Search Ads 360 客户支持团队联系。
请提供您的开发者项目 ID，以及此表行（而非下方表行）中的代码和原因。
|
410 |
reportUnavailableQuotaExceeded |
由于开发者项目今天请求的数据量过多，因此系统无法再处理该报告。 |
确保您的客户端发送的请求不超出您的预期。您可以在 Google Cloud 控制台中跟踪配额用量。
如果客户的效果符合预期，请与 Search Ads 360 客户支持团队联系，申请增加配额。请提供您的开发者项目 ID，以及此表行（而非上面的表行）中的代码和原因。
另请参阅价格和用量限制。
|
410 |
reportUnavailableInternalServerError |
Search Ads 360 因某些意外原因而无法返回或生成报告。 |
与 Search Ads 360 客户支持团队联系。请附上您的报告 ID。
|
410 |
reportUnavailableRequestError |
即使请求通过了验证，Search Ads 360 也无法生成请求的报告，因为其中包含无效的列、过滤条件和细分组合。 |
与 Search Ads 360 客户支持团队联系。请附上您的报告 ID。 |
400 |
unsupportedApiVersion |
版本不受支持。 |
改用 Search Ads 360 Reporting API。 |
对于所有其他类型的错误，该 API 都会返回标准错误响应。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2024-12-05。
[null,null,["最后更新时间 (UTC)：2024-12-05。"],[[["\u003cp\u003eSearch Ads 360 API returns a \u003ccode\u003e200\u003c/code\u003e HTTP status code for successful requests and a status code between \u003ccode\u003e400\u003c/code\u003e and \u003ccode\u003e499\u003c/code\u003e for validation failures.\u003c/p\u003e\n"],["\u003cp\u003eIf a valid report request cannot be generated, the API returns a \u003ccode\u003e410\u003c/code\u003e status code with a specific reason, such as the report being too large, rate limit exceeded, or internal server error.\u003c/p\u003e\n"],["\u003cp\u003eFor report generation failures, recommended actions include requesting smaller reports, checking client request frequency, contacting support for quota increases, or reviewing report configurations.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides detailed descriptions and recommended actions for each type of report generation failure, helping users troubleshoot and resolve issues effectively.\u003c/p\u003e\n"],["\u003cp\u003eFor other errors, refer to the Standard Error Responses documentation for guidance.\u003c/p\u003e\n"]]],["Successful Search Ads 360 API requests return a `200` status code. Validation failures result in `400-499` codes, with error descriptions. If report generation fails, `410` codes indicate issues like excessive size, rate limits, quota overages, internal errors, or invalid report specifications; each with specific resolution steps. A `400` error indicates an unsupported API version. Other errors follow standard error responses.\n"],null,["# Response Codes in the Search Ads 360 API\n\nIf a request to the Search Ads 360 API is **successful** , the API returns\na `200` HTTP status code along with the requested data in the body of the response.\n\nIf a request **fails to validate** , the API returns an HTTP status code between\n`400` and `499` along with a description of the validation error.\n\nIf you send a valid [`Report.get()`](/search-ads/v2/reference/reports/get)\nrequest but Search Ads 360 is **unable to generate a report**, the API returns\none of the HTTP status codes described below.\n\n| Code | Reason | Description | Recommended action |\n|------|--------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 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. |\n| 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](https://support.google.com/searchads/answer/3280641). Include your developer project ID, and the Code and Reason from this table row (and not the one below). |\n| 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](https://support.google.com/searchads/answer/9026876) 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](/pricing). |\n| 410 | reportUnavailableInternalServerError | Search Ads 360 is unable to return or generate the report for some unexpected reason. | [Contact Search Ads 360 customer support](https://support.google.com/searchads/answer/9026876). Include your report ID. |\n| 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](https://support.google.com/searchads/answer/9026876). Include your report ID. |\n| 400 | unsupportedApiVersion | Version not supported. | Migrate to the Search Ads 360 Reporting API. |\n\nFor all other types of errors, the API returns\n[Standard Error Responses](/search-ads/v2/standard-error-responses)."]]
