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 配額。詳情請參閱標準查詢參數摘要。

報表 API

下列配額適用於所有 Reporting API，包括 Core Reporting API v3、Analytics Reporting API v4、Real Time API v3 和 Multi-channel Funnel API v3：

  • 每個資料檢視 (設定檔) 每日 10,000 個要求 (無法增加)
  • 每個資料檢視 (設定檔) 10 個並行要求 (無法增加)

Reporting API 要求錯誤

如果向 Reporting API 發出的要求失敗並顯示伺服器錯誤，您會收到回應代碼 500 或 503。您可以重新提交要求，但如果要求不斷失敗，請勿重複提交。Google Analytics (分析) 提供以下功能：

  • 每個專案每個資料檢視 (設定檔) 每小時 10 個伺服器錯誤失敗要求
  • 每個專案每個資料檢視 (設定檔) 每天 50 個伺服器錯誤失敗要求

如果失敗的要求數量超過這些配額，您會收到下列錯誤訊息：

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

如要降低要求伺服器錯誤的機率，請透過以下方式簡化要求：降低日期範圍、減少要求中的維度數量，或減少要求中的指標數量。

請勿持續重新提交失敗的要求。請改為實作指數輪詢來重新提交。

系統會依據每小時和每日錯誤率配額，在滾動週期內強制執行伺服器錯誤率配額。在專案一小時後，且查看配對的第一項伺服器錯誤後，配額就會重設。如果專案和檢視畫面組合在一小時內傳送 10 個伺服器錯誤，則專案和檢視配對會從 API 遭到封鎖，直到第一個伺服器錯誤發生後的數小時為止。

舉例來說，如果專案和檢視畫面組合在過去 24 小時內都未能傳送伺服器錯誤，則這項專案和檢視畫面的配額中，會用掉 0 個配額。假設這個專案和檢視畫面現在在上午 6:12 傳送伺服器錯誤。如果這項專案並在隔天凌晨 6:12 前傳送 49 個額外的伺服器錯誤，這個專案和檢視畫面將遭到封鎖，直到隔天凌晨 6:12 為止。隔天凌晨 6 點 12 分，這項專案和檢視畫面的伺服器錯誤率配額會完全重設。

超過配額上限

如果超過要求 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 及限制用量」。