下列限制和配額適用於 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 可能會受到門檻限制。系統會套用門檻，避免查看報表的任何人推斷個別使用者的特徵或興趣。
資源權杖配額
每次向 Google Analytics Data API v1 發出要求時，都會消耗權杖。系統會根據要求的複雜程度，收取不同數量的權杖費用。大多數要求會收取 10 個以下的符記，但較複雜的要求會消耗更多符記。
影響權杖用量的因素
系統會在執行要求時決定確切的權杖費用，因此很難事先精確計算。費用會受到多種因素影響，包括要求本身，以及 Google Analytics 資源中的基礎資料。以下因素可能會導致費用增加：
- 資料列數：要求較多的資料列。
- 維度和指標數量：納入更多維度和指標。
- 篩選器複雜度：使用複雜的篩選運算式。
- 日期範圍長度：查詢較長的日期範圍。
- 資料基數：高基數維度 (許多不重複值，例如
pagePath、自訂維度) 可能會大幅增加權杖費用。 - 資源事件量：如果資源的事件量較高，對該資源進行查詢時，可能會比對資料量較少的資源進行相同查詢時，消耗更多權杖。
監控權杖用量
如要判斷特定 API 呼叫的權杖成本，最有效的方法是在要求主體中加入 "returnPropertyQuota": true 參數。API 回應隨後會包含 PropertyQuota 物件，其中詳細列出該特定要求使用的權杖，以及剩餘配額餘額。