每項 API 要求都會驗證配額並未用盡,並會耗用配額。如果配額用盡,要求就會失敗,並顯示相關的錯誤訊息。每個 Data API 要求都會檢查多個配額值區。
配額類別
就配額而言,Data API 有三種要求類別:「Core」、「Realtime」和「Funnel」。向 Core 方法發出的 API 要求會收取核心配額。 向 Realtime 方法發出的 API 要求都會收取即時配額。一項要求不會同時耗用 Core 和 Realtime 配額。以下是 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 中指定這個參數。