配額

每項 API 要求都會驗證配額並未用盡,並會耗用配額。如果配額用盡,要求就會失敗,並顯示相關的錯誤訊息。每個 Data API 要求都會檢查多個配額值區。

配額類別

就配額而言,Data API 有三種要求類別:「Core」、「Realtime」和「Funnel」。向 Core 方法發出的 API 要求會收取核心配額。 向 Realtime 方法發出的 API 要求都會收取即時配額。一項要求不會同時耗用 Core 和 Realtime 配額。以下是 API 方法和類別:

配額類別 API 方法
Core runReportrunPivotReportbatchRunReportsbatchRunPivotReportsrunAccessReportgetMetadatacheckCompatibilitycreateAudienceExports
即時互動 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 個可能設有閾值的要求。userAgeBracketuserGenderbrandingInterestaudienceIdaudienceName 維度可能設有門檻。系統會套用閾值,避免任何人在查看報表時推斷個別使用者的客層或興趣。

屬性符記配額

系統會根據要求的複雜程度,在每次要求中計算權杖。大多數要求會收取 10 個以下的權杖,要求使用大量配額權杖時,通常是下列因素:

  • 大量資料列
  • 大量欄
  • 複雜篩選條件
  • 日期範圍過長

針對每個 API 要求,您可以在要求主體中指定 "returnPropertyQuota": true,以傳回目前的資源配額權杖狀態。此狀態包含此要求使用的金額,以及每個配額群組的剩餘金額。例如,請考慮在 RunReportRequest 中指定這個參數。