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 minute
和 Requests per minute per user
配額。以任何方式修改 Google Analytics (分析) 帳戶設定的方法 (create
、patch
、delete
、archive
、update
方法) 發出的要求也會使用 Writes per minute
和 Writes per minute per user
配額。
如要瞭解如何為每位使用者限制 API 要求,請參閱「限制 API 用量」一文。