配额可保护 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。
- 在指标 页面查看您的使用情况统计信息，确保您的 应用按预期正常运行。密切关注已被调用的方法，先解决任何意外使用或过度使用的问题，然后再继续操作。
- 如果使用情况看似正常，请转到配额 页面，点击修改图标 旁边的每天查询次数，然后点击“申请更高配额”链接。
在提交希望提高配额的申请之前，请务必仔细查看相关信息，并按照 配额申请表单中的说明操作。