本文說明要求 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)。
Management API
Google Analytics (分析) 對下列 Management API 請求設有配額:
編寫 API
下列配額適用於寫入 (insert
、update
、patch
和 delete
) 要求:
- 每個專案每日 50 個寫入要求,可以提高
- 每個帳戶 ID 每秒 1.5 次查詢 (QPS)
寫入要求錯誤
如果寫入要求失敗,且收到回應代碼 500
或 503
,您可以重新提交要求。Google Analytics (分析) 提供以下功能:
- 每小時 50 次失敗的寫入要求。
如果您每小時嘗試提交的失敗寫入要求超過 50 次,系統就會顯示下列錯誤訊息:
Quota Error: The number of recent failed writes is too high.
請改為實作指數輪詢以重新提交,而不要持續重新提交失敗的寫入要求。
資料匯入 API
這些配額是 Uploads
資源的專屬配額:
- 生命週期擴充資料匯入儲存空間限制 (不適用於從收集 API 和 SDK 傳送的命中資料):
- 每個資源 50 個資料集
- 每天每個資源 50 項上傳作業
- 每個已上傳檔案 1 GB
- 費用資料特殊限制:
- 每個資料集每天 (
ga:date
) 100 MB。例如,如果您在第二次上傳時針對 2014-10-10 匯入 50 MB 的資料,在第二次上傳時匯入了 50 MB 的資料,則您已達到該資料集 2014-10-10 的 100 MB 上限。
- 每個資料集每天 (
實驗 API
這項配額僅適用於實驗:
- 每次資料檢視 (設定檔) 12 個實驗
含有以下任一 statuses
的實驗會計入這項配額:
DRAFT
READY_TO_RUN
RUNNING
超過一天的實驗 (狀態 = ENDED
) 不會計入配額。
未取樣 Reports API
這些配額僅適用於未取樣報表:
- 建立未取樣報表的 API 要求會計入一般的寫入要求配額。
- API 會使用與網頁介面用來建立未取樣報表的「每個資源每日」權杖系統。
- 未取樣報表數量上限為 3,500 份。達到這個上限時,嘗試建立進一步的未取樣報表,納入以下的 API 結果:
Error creating this entity. You have reached the maximum allowed entities of this type.
User Permission API
這項配額僅適用於使用者權限:
- 每位使用者最多可擁有 100 個 Analytics (分析) 帳戶。將擁有 100 個 Analytics (分析) 帳戶的使用者加入新帳戶會導致錯誤。
下列配額適用於使用者權限的批次寫入 (delete
、insert
、update
) 要求:
超過配額上限
如果超過要求 Google Analytics (分析) API 的配額,API 會傳回錯誤代碼 403
或 429
,並指出帳戶已超出配額的訊息。詳情請參閱《服務條款》。
申請更多配額
您只能要求增加:
- 每項專案的每日讀取要求數 (預設 50,000 個)
- 每項專案的每日寫入要求數 (預設 50 個)
如要查看或變更專案的用量限制,或是想申請更多配額,請進行以下步驟:
- 確認您的專案已設有帳單帳戶。如果沒有,請先建立一個。
- 開啟 API 控制台並前往 API 程式庫「已啟用的 API」頁面,從清單中選取 API。
- 如要查看及變更配額相關設定,請點選「配額」。如要查看用量統計資料,請點選「用量」。
如要申請提高配額上限,請使用 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 及限制用量」。