Data API 限制和配額

下列限制和配額適用於 Data API。

配額類別

Data API 有三個要求配額類別：核心、即時和漏斗。對 Core 方法提出的 API 要求會耗用 Core 配額。對 Realtime 方法提出的 API 要求會收取 Realtime 配額費用。每項要求只會耗用一種配額。

配額類別 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 中指定這個參數。