我們會為 API 要求設定限制和配額,避免系統收到過多無法處理的資料,並確保系統資源公平分配。限制和配額可能會有所變動。
頻率限制
API 頻率限制定義了可對 Google Marketing Platform 管理員 API 發出的要求數。系統會強制執行頻率限制,並在 60 秒 (1 分鐘) 的間隔內自動補充。也就是說,如果您的專案在 60 秒內達到速率限制上限,就必須等待配額重新填滿,才能在該群組中提出更多要求。如果專案超出費率限制,您會收到 403 錯誤,並顯示 rateLimitExceeded
為原因。如要解決這項錯誤,請稍候片刻,然後再次提出要求。下一個間隔開始時,配額應會重新填充。
每日 API 要求的數量上限自然受到 API 速率限制的限制,目前 Google Marketing Platform 管理員 API 並未設有明確的每日用量配額。
Cloud 專案配額
每項專案的 API 頻率限制可能不同。
Cloud 控制台會顯示 Cloud 專案的配額:https://console.cloud.google.com/apis/api/marketingplatformadmin.googleapis.com/quotas。
以下是 Google Marketing Platform 管理員 API 的預設配額,大多數使用者會在控制台中看到這些配額。
配額名稱 | 限制 |
---|---|
每分鐘要求數 | 1,200 |
每位使用者每分鐘的要求數 | 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 用量」一文。