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 都会返回标准错误响应。