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 和設定用量上限」。