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