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