API 请求的限制和配额
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
我们对 API 请求设置了限制和配额,以防止系统收到的数据量超出其处理能力,并确保公平分配系统资源。这些限制和配额随时可能发生变化。
速率限制
API 速率限制定义了可向 Google Marketing Platform Admin API 发出的请求数。速率限制是强制执行的,并且每隔 60 秒(1 分钟)自动重新填充。也就是说,如果您的项目在 60 秒内达到速率上限,则需要等待配额重新填充,然后才能在该组中发出更多请求。如果您的项目超过速率限制,您会收到 403 错误和原因 rateLimitExceeded
。如需解决此错误,请等待一分钟再重新发送请求,配额应该会在下一个间隔开始时重新填充。
每日 API 请求次数上限自然受到 API 速率限制的约束,目前 Google Marketing Platform Admin API 没有明确的每日用量配额。
Cloud 项目配额
API 速率限制按项目计算。
Cloud 控制台会显示 Cloud 项目的配额:https://console.cloud.google.com/apis/api/marketingplatformadmin.googleapis.com/quotas。
以下是 Google Marketing Platform Admin API 的默认配额,大多数用户会在其控制台中看到这些配额。
配额名称 |
限制 |
每分钟请求数 |
1200 |
每位用户每分钟的请求数 |
600 |
每分钟写入次数 |
300 |
每位用户每分钟的写入次数 |
120 |
对 Google Marketing Platform Admin API 的每次请求都会消耗 Requests per minute
、Requests per minute per user
配额。对以任何方式更改 Google Marketing Platform 账号配置的任何方法(create
、patch
、delete
、archive
、update
方法)的请求也会消耗 Writes per minute
和 Writes per minute per user
配额。
如需了解如何按用户限制 API 请求,请参阅限制 API 用量一文。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-07-25。"],[[["The Google Marketing Platform Admin API has rate limits to ensure fair usage and system stability, replenishing every 60 seconds."],["Exceeding these limits results in a 403 error, requiring a brief pause before retrying."],["While daily usage is implicitly limited by per-minute rates, there's no separate daily quota."],["Quotas are project-specific and categorized into requests/writes per minute, further divided by per-user limits."],["Users can manage per-user API request limitations through features detailed in the \"Capping API usage\" article."]]],[]]