API 要求的限制和配額

Google Analytics (分析) 供數百萬個網站使用。我們針對 API 要求設定限制和配額,以防系統接收超出系統能處理的資料量,並確保系統資源能公平地分佈。相關限制和配額可能隨時變動。

頻率限制

API 頻率限制定義了可對 Google Analytics Admin API 發出的要求數量。系統會強制執行頻率限制,並以 60 秒 (1 分鐘) 的間隔自動重新填入值。也就是說,如果專案在 60 秒內隨時達到頻率限制的上限,您就必須等到配額重新補充後,才能在群組中提出更多要求。如果專案超出頻率限制,您會收到 403 錯誤,原因為 rateLimitExceeded。如要解決這個錯誤,請稍待片刻,然後再重試要求 (下次間隔開始時應重新計算配額)。

每日 API 要求數量上限本身通常會受到 API 頻率限制的限制,而 Google Analytics Admin API 目前沒有明確的每日用量配額。

Cloud 專案配額

每項專案的 API 頻率限制可能不同。

Cloud 控制台會顯示 Cloud 專案的配額:https://console.cloud.google.com/apis/api/analyticsadmin.googleapis.com/quotas

以下是大多數使用者會在控制台中看到的 Google Analytics Admin API 預設配額。請注意,我們可能會針對違反《Google Analytics (分析) 服務條款》的專案自動限製配額限制。

配額名稱 限制
每分鐘要求數 1,200
每位使用者的每分鐘要求數 600
每分鐘寫入數 600
每位使用者每分鐘的寫入數 180

每個傳送至 Google Analytics Admin API 的要求都會耗用 Requests per minuteRequests per minute per user 配額。以任何方式修改 Google Analytics (分析) 帳戶設定的方法 (createpatchdeletearchiveupdate 方法) 發出的要求也會使用 Writes per minuteWrites per minute per user 配額。

如要瞭解如何為每位使用者限制 API 要求,請參閱「限制 API 用量」一文。