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

這項配額適用於寫入要求 (例如createAccountTicket) 至 Provisioning API

  • 每項專案每日 50 個要求
  • 每個帳戶 ID 每秒 1.5 次查詢 (QPS)

超出配額限制

如果超過 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 和用量上限