API 要求的限制和配額

為確保 Google Analytics 系統不會收到超出處理能力的資料量，並確保系統資源能平均分配給使用者，Google Analytics API 會對您的用量強制執行部分限制和配額。

下列限制和配額適用於 Google Cloud 雲端專案層級的整體 Google Analytics API 用量 (不包括 Data API 呼叫)：

  • 每個專案每天最多 50,000 個要求。
  • 每個 IP 位址每秒 10 次查詢 (QPS)。
    • API 控制台中也有類似的配額，稱為「每位使用者每 100 秒的要求數」。根據預設，每位使用者每 100 秒可提出 100 個要求，最多可調整為 1,000 個。但向 API 發出的要求數量不得超過每位使用者每秒 10 次的上限。
    • 如果應用程式是從單一 IP 位址發出所有 API 要求 (例如代表使用者)，請在每個要求中使用 userIp 或 quotaUser 參數，為每位使用者取得完整的每秒查詢次數配額。

部分 API 設有額外限制。如要瞭解特定 API 的限制和配額，請參閱下列頁面：

與限制和配額相關的錯誤

如果超出 Google Analytics API 的要求配額，API 會傳回錯誤代碼 403 或 429，以及帳戶超出配額的訊息。詳情請參閱服務條款。

如要進一步瞭解配額管理，以及如何微調應用程式的配額用量，請參閱「監控 API 和限制用量」。