API 要求的限制和配額

本文說明要求 Management API 和 Reporting API 的限制和配額。

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

這部影片說明管理 Google Analytics (分析) API 要求配額的最佳做法。

一般配額限制

Management API、Core Reporting API v3、MCF Reporting API、Metadata API、User Deletion API 和 Real Time Reporting API 均適用下列配額：

  • 每個專案每日 50,000 個要求，可以增加。
  • 每個 IP 位址每秒 10 次查詢 (QPS)。
    • 在 API 控制台中，也有類似「每位使用者每 100 秒要求數」的配額。預設值為每位使用者每 100 秒 100 個要求，且可調整為最大值 1,000。不過，傳送至 API 的要求數量限制為每位使用者每秒 10 個要求。
    • 如果應用程式透過單一 IP 位址發出所有 API 要求 (即代表使用者)，請在每個要求中使用 userIP 或 quotaUser 參數，取得每位使用者的完整 QPS 配額。詳情請參閱標準查詢參數摘要。

超過配額上限

如果超過要求 Google Analytics (分析) API 的配額，API 會傳回錯誤代碼 403 或 429，並指出帳戶已超出配額的訊息。詳情請參閱《服務條款》。

申請更多配額

您只能要求增加：

如要查看或變更專案的用量限制，或是想申請更多配額，請進行以下步驟：

  1. 確認您的專案已設有帳單帳戶。如果沒有，請先建立一個。
  2. 開啟 API 控制台並前往 API 程式庫「已啟用的 API」頁面，從清單中選取 API。
  3. 如要查看及變更配額相關設定，請點選「配額」。如要查看用量統計資料，請點選「用量」。

如要申請提高配額上限，請使用 Analytics (分析) API 配額申請表單。提交要求前，請務必查看相關資訊，並按照配額要求表單中的指示操作。針對 Reporting API v4，Google API 控制台中的 API 名稱為 Google Analytics Reporting API。所有其他第 3 版 API (例如Management API v3、Core Reporting API v3、Real Time Reporting API v3、User Deletion API v3) 則會列在 Google API 控制台的 Analytics API 下方。

如需進一步瞭解配額管理，以及如何調整應用程式來使用配額，請參閱「監控 API 及限制用量」。