API 要求的限制與配額

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

目前已有數百萬個網站使用 Google Analytics (分析)。我們會針對 API 要求設下限制和配額,藉此防止系統收到的資料量超過其能處理的數量,並確保系統資源能以公平的方式發布。限制和配額隨時可能變動。

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

一般配額限制

Management APICore Reporting API v3MCF Reporting APIMetadata APIUser Deletion APIReal Time Reporting API 適用的配額如下:

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

報表 API

以下配額適用於所有 Reporting API,包括 Core Reporting API v3Analytics Reporting API v4Real Time API v3多管道漏斗 API v3

  • 每天每次資料檢視 (設定檔) 10,000 個要求 (無法增加)
  • 每個資料檢視 (設定檔) 10 個並行要求 (無法增加)
Analytics Real Time Reporting API 呼叫會與其他 Analytics (分析) API 分開計算,這表示您可以使用 Analytics Real Time Reporting API 每天發出 10,000 次呼叫,而且每天使用任何其他 Analytics (分析) API 進行 10,000 次呼叫。

這項行為提供更精細且不安全的配額管理方法,因此使用 Analytics Real Time Reporting API 頻繁呼叫時,不會不小心封鎖到當天其餘的 Analytics (分析) API 呼叫 (設定檔)。

Reporting API 要求錯誤

如果傳送至 Reporting API 的要求因伺服器錯誤而失敗,您會收到回應代碼 500503。您可以重新提交要求;不過,如果這項要求反覆失敗,請勿重複提交一次。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 個配額中的 50 個配額。假設這個專案和資料檢視現在在早上 6:12 傳送伺服器錯誤。如果這個專案和資料檢視在次日凌晨 6:12 前傳送另外 49 個伺服器錯誤,則這個專案和資料檢視將遭到封鎖,直到次日凌晨 6 點 12 分為止。到了次日凌晨 6:12,這項專案和檢視表的伺服器錯誤率配額將會完全重設。

超出配額限制

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

申請更多配額

但只能要求調高下列項目:

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

  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 下。

如要進一步瞭解配額管理以及如何調整應用程式以達到配額用量,請參閱 Monitoring API 和用量上限