API 要求的限制和配額

數百萬個網站都使用 Google Analytics (分析),我們對 API 要求設有限制和配額,以避免系統接收超過處理量的資料量,並確保系統資源公平分配。這些限制和配額隨時可能變動。

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

User Deletion API 有下列配額規定:

  • 每個專案每日 50,000 個要求,可以增加
  • 每個 IP 位址每秒查詢 10 次 (QPS)。
    • API 控制台所提供的配額類似,稱為「每位使用者每 100 秒要求數」。根據預設,這個數值會設為每位使用者每 100 秒每 100 秒 100 個要求,可調整為 1,000 個最大值。不過,向 API 發出的要求數量限制為每位使用者每秒最多可要求 10 次。
    • 如果應用程式從單一 IP 位址發出所有 API 要求 (例如代表使用者),請在每項要求中使用 userIPquotaUser 參數,取得每位使用者的完整 QPS 配額。詳情請參閱標準查詢參數摘要
  • 每項資源或 Firebase 專案的每秒查詢次數 (QPS) 1.5
  • 每項雲端專案每日 500 次查詢 (QPD)

超過配額限制

如果超過 Google Analytics (分析) API 的要求配額,API 會傳回錯誤代碼 403429,以及帳戶超過配額的訊息。詳情請參閱《服務條款》。

申請更多配額

您只能要求提高:

  • 每項專案的每日讀取要求數 (預設要求 50,000 個)。
  • 每項專案的每日寫入要求數 (預設值為 50)。

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

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

如要申請提高配額上限,請使用 Analytics API 配額申請表。提交要求前,請務必查看相關資訊,並按照配額要求表單中的指示操作。

如要進一步瞭解配額管理以及如何調整應用程式來達到配額用量,請參閱「監控 API 與限制用量」一文。