下列限制和配額適用於 Data API。
配額適用方式
所有對 Google Analytics Data API v1 發出的要求都需要 Google Cloud 專案，且須遵守本頁面列出的配額。無論使用哪種方法識別呼叫專案，都會消耗配額，包括：
- 使用 OAuth 2.0 憑證驗證的要求。
- 僅使用 API 金鑰驗證的要求。
API 金鑰可將要求與特定 Google Cloud 專案建立關聯，用於配額和帳單用途。使用專案憑證或 API 金鑰發出的所有 API 呼叫，都會計入專案和 Google Analytics 資源的適用配額。
配額類別
Data API 有三種要求配額類別：核心、即時和漏斗。對 Core 方法發出的 API 要求會計入 Core 配額。對即時方法發出的 API 要求會耗用即時配額。每項要求只會耗用一種配額。
| 配額類別 | API 方法 |
|---|---|
| Core | runReport、runPivotReport、batchRunReports、batchRunPivotReports、runAccessReport、getMetadata、checkCompatibility、createAudienceExports |
| 即時 | runRealtimeReport |
| 漏斗 | runFunnelReport |
Analytics 資源配額
所有要求都會消耗資源配額。
| 配額名稱 | 標準資源限制 | Analytics 360 資源限制 |
|---|---|---|
| 每項資源每天的核心權杖數 | 200,000 | 2,000,000 |
| 每小時每個資源的核心權杖 | 40,000 | 400,000 |
| 每項專案每項資源每小時的核心權杖數 | 14,000 | 140,000 次 |
| 每個資源的核心並行要求 | 10 | 50 |
| 每個屬性每小時的每個專案核心伺服器錯誤 | 10 | 50 |
| 每項資源每天的即時權杖數 | 200,000 | 2,000,000 |
| 每小時每個房源的即時權杖 | 40,000 | 400,000 |
| 每項專案每項資源每小時的即時權杖數 | 14,000 | 140,000 次 |
| 每個資源的即時並行要求 | 10 | 50 |
| 每項專案每項資源每小時的即時伺服器錯誤 | 10 | 50 |
| 每個資源每天的漏斗權杖數 | 200,000 | 2,000,000 |
| 每個資源每小時的漏斗權杖 | 40,000 | 400,000 |
| 每個資源每項專案每小時的漏斗權杖 | 14,000 | 140,000 次 |
| 每個資源的漏斗並行要求 | 10 | 50 |
| 每個屬性每小時的每個專案漏斗伺服器錯誤 | 10 | 50 |
- 並行要求是指同時執行的要求數量。如要減少要求並行，請等待先前要求完成，再傳送其他要求。
- 伺服器錯誤代碼為 500 和 503。只有在要求導致伺服器錯誤時，才會計入伺服器錯誤配額。如果專案和資源組合的伺服器錯誤配額用盡，系統會封鎖專案對資源的所有要求。
- 每項要求都會耗用「每個資源每小時的權杖數」和「每個專案每個資源每小時的權杖數」配額。也就是說，如果一個資源由超過 3 個專案存取，則「每小時每個資源的權杖數」配額可能會在「每小時每個專案每個資源的權杖數」配額用盡前就達到上限。
資源每小時最多可提出 120 個可能超出門檻的要求。維度 userAgeBracket、userGender、brandingInterest、audienceId 和 audienceName 可能會受到門檻限制。系統會套用門檻，避免查看報表的任何人推斷個別使用者的特徵或興趣。
資源權杖配額
系統會根據要求複雜度，在每次要求時計算權杖。大多數要求會收取 10 個或更少的權杖。如果要求耗用大量配額權杖，通常是下列因素所致：
- 大量資料列
- 大量資料欄
- 複雜的篩選條件
- 日期範圍較長
每次發出 API 要求時，您都可以在要求本文中指定 "returnPropertyQuota": true，傳回目前的資源配額權杖狀態。這項狀態包含這項要求耗用的量，以及每個配額群組的剩餘量。舉例來說，請考慮在 RunReportRequest 中指定這個參數。