如果对 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 |
版本不受支持。请参阅 停用详情。 |
对于所有其他类型的错误,该 API 会返回标准错误响应。