Search Ads 360 API 中的响应代码

如果对 Search Ads 360 API 的请求成功,API 会在响应正文中随请求的数据一并返回 200 HTTP 状态代码。

如果请求验证失败,API 会返回 400499 之间的 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 会返回标准错误响应