API 要求的限制與配額

本文說明要求管理 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 個並行要求 (不可增加)

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 小時內未傳送伺服器錯誤,這項專案和檢視畫面會使用 50 項配額中的 0 項。假設這個專案和檢視表現在在早上 6:12 傳送伺服器錯誤。如果這個專案和檢視畫面在隔天的上午 6:12 之前傳送了 49 個伺服器錯誤,則這項專案和檢視畫面將在隔天上午 6:12 之前遭到封鎖。隔天上午 6:12 時,這個專案和檢視畫面的伺服器錯誤率配額將完全重設。

Analytics Reporting API v4

這些配額僅適用於 Analytics Reporting API v4

  • 每項專案每日的要求數量:50,000
  • 每個資料檢視 (設定檔) 每天的要求數量:10,000 (無法增加)
  • 每項專案每 100 秒的要求數量:2,000
  • 每項專案每 100 秒的要求數量:100 個 (您可以在 Google API 控制台中增加為 1,000 個)。

您可以在 Google API 控制台中查看專案的配額。

資源配額

Analytics Reporting API v4 也受到選用的資源型配額規範,該功能可讓 Analytics (分析) 360 客戶使用較高的取樣門檻。

超過配額限制

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

申請更多配額

您只能要求提高:

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

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

如要申請提高配額,請使用 Analytics API 配額申請表單。提交資訊前,請務必詳閱資訊要求,並按照配額申請表單中的指示操作。針對 Reporting API v4,Google API 控制台中的 API 名稱為 Google Analytics Reporting API。所有其他 v3 API (例如Management API 第 3 版、核心報表 API 第 3 版、即時報表 API 第 3 版、使用者刪除 API 第 3 版) 列在 Google API 控制台的 Analytics API 中。

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