配额可保护 Google 基础架构免受自动流程以不当方式使用 Campaign Manager 360 API 的影响。它们可以确保一个开发者的行为对广大社区产生负面影响。
配额限制
所有 Campaign Manager 360 API 资源和方法均需遵循下列默认配额限制。
- 每个项目每天 50000 个请求 - 可以增加。
- 每个项目的每秒查询数 (QPS) 为 1 次。
- 在 Google API 控制台中，此配额称为每位用户每分钟的查询数，默认设置为 60。此限制可根据需要提高，最高不超过 600 (10 QPS)。
报表制作工具会强制执行因帐号而异的额外配额限制。如需了解详情，请参阅这篇帮助中心文章和下表。
超出配额限制
在极少数情况下，如果您的请求因超出配额限制而失败，该 API 会返回 HTTP 状态代码以及错误原因。此外，响应正文还将详细说明出错的原因。如需查看错误响应示例，请参阅错误消息指南。
以下列表显示了由于超出配额限制而导致请求失败可能的错误和推荐措施。
| 编码 | 原因 | 讯息 | 建议采取的措施 |
|---|---|---|---|
| 403 | dailyLimitExceeded | 已超出每日上限 | 在解决问题之前，请勿重试。在 Google API 控制台中检查您的使用情况，并修改工作流程以减少请求数量。如果您认为自己的使用量合理，则可以申请增加配额。 |
| 403 | quotaExceeded | 此帐号已超出每日 x 份报告的配额。 | 这一天，请不要再尝试为此帐号生成任何报告。请向您的客户经理求助。 |
| 403 | quotaExceeded | 这份用户个人资料已超出其每日 x 个报表的配额。 | 这一天，请勿再尝试为此用户个人资料生成更多报告。请切换到其他用户个人资料，或向您的客户经理寻求帮助。 |
| 403 | quotaExceeded | 此帐号已超出定期生成的 x 份报告的配额。 | 请先停用不需要的定期报表，然后重试此请求。 |
| 403 | quotaExceeded | 拥有此报告的用户个人资料已超过其 x 份有效定期报告的配额。 | 请让此报告的所有者停用不需要的定期报表，然后重试此请求。 |
| 403 | quotaExceeded | 这份用户个人资料已超出其定期生成的 x 份有效报表的配额。 | 请先停用不需要的定期报表，然后重试此请求。 |
| 403 | quotaExceeded | 无法完成此操作，因为已经超出您的某项配额。请与您的客户经理联系，以获取帮助。 | 请向您的客户经理求助。 |
| 403 | userRateLimitExceeded | 已超出用户速率限制 | 在 Google API 控制台中提高每位用户限制，或使用指数退避算法减慢您发送请求的速率。建议不要通过此 API 发出并发写入请求或采用高于 10 QPS 的速率限制。 |
申请更多每日配额
如果您认为自己的应用需要更多每日配额，可以按照以下说明申请更多配额。
以下说明仅适用于遇到 dailyLimitExceeded 错误的项目。如需了解其他配额错误的建议操作，请参阅上表。
- 在 Google API 控制台中转到 Campaign Manager 360 API。
- 从指标页面查看您的使用情况统计信息，确保您的应用按预期正常运行。密切关注被调用的方法，并解决任何意外或过度使用的问题，然后再继续。
- 如果使用情况看起来正常，请转到配额页面，点击每日查询数旁边的修改图标，然后点击“申请更高配额”链接。
在提交配额增加申请之前，请务必查看相关信息，并按照配额申请表单中的说明操作。