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

注意： 系統會在太平洋時間凌晨 12 點更新每日配額。

Management API

Google Analytics (分析) 對下列 Management API 請求設有配額：

• 編寫 API
• 資料匯入 API
• 實驗 API
• 未取樣 Reports API
• User Permission API

編寫 API

下列配額適用於寫入 (insert、update、patch 和 delete) 要求：

• 每個專案每日 50 個寫入要求，可以提高
• 每個帳戶 ID 每秒 1.5 次查詢 (QPS)

注意： 如果是 Analytics (分析) 帳戶，對 User Permission API 發出的 30 次批次寫入 (delete、insert、update) 要求將計為 (1) 一次寫入要求，以及 (2) 30 個要求計入每項專案的每日要求數量上限。比方說，使用者權限 API 發出的 90 次批次寫入要求會計為 (1) 3 次寫入要求，以及 (2) 90 個個別要求，以計入每日專案上限。這項獎勵僅適用於傳送至 User Permission API 的要求。

寫入要求錯誤

如果寫入要求失敗，且收到回應代碼 500 或 503，您可以重新提交要求。Google Analytics (分析) 提供以下功能：

• 每小時 50 次失敗的寫入要求。

如果您每小時嘗試提交的失敗寫入要求超過 50 次，系統就會顯示下列錯誤訊息：

Quota Error: The number of recent failed writes is too high.

請改為實作指數輪詢以重新提交，而不要持續重新提交失敗的寫入要求。

資料匯入 API

這些配額是 Uploads 資源的專屬配額：

• 生命週期擴充資料匯入儲存空間限制 (不適用於從收集 API 和 SDK 傳送的命中資料)：
  • 「處理時匯入」模式的 Analytics (分析) 360 限制：
    • 每項資源 1 TB
    • 每個資料集 20 GB
  • 查詢時匯入模式的 Analytics (分析) 360 限制：
    • 每個資源 1 GB
    • 每個資料集 1 GB
  • 標準限制：
    • 每個資源 10 GB
    • 每個資料集 10 GB
• 每個資源 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) 要求：

• 每個批次要求最多 300 個使用者權限寫入要求
• 系統會將 30 個批次使用者權限寫入要求計為 1 個「寫入要求」

超過配額上限

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

申請更多配額

您只能要求增加：

• 每項專案的每日讀取要求數 (預設 50,000 個)
• 每項專案的每日寫入要求數 (預設 50 個)

注意： 每個資料檢視 (設定檔) 的每日 10,000 個要求，或每個資料檢視 (設定檔) 的 10 個並行要求無法增加。

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

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 及限制用量」。