API 要求的限制和配額

我們會為 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 用量」一文。