依資源計算的配額

本文件說明 Google Analytics Reporting API v4 的資源型配額系統，但僅適用於 Analytics (分析) 360 客戶。如要瞭解 API 適用的完整限制，請參閱 API 限制和配額。

簡介

為了確保共用資源的可用性與可靠性，每個存取 Analytics Reporting API 的專案都受到限制與配額的規範。查詢大型資料集時，Analytics (分析) Reporting API 可能會使用取樣，這可能會影響資料結果。

以資源為基礎的配額系統是一項新的配額系統，可讓 Analytics (分析) 360 帳戶在使用 Analytics Reporting API 時採用更高的取樣門檻。這套系統是選用系統，不受限於現有的檢視表和專案限制，例如 Google API 控制台「配額」頁面中回報的限制。

以資源為基礎的配額

並非所有要求都會相等，有些要求的運算成本比其他要求高出許多。以資源為基礎的配額系統旨在支援更高的取樣門檻，同時還能保護 Analytics (分析) 報表基礎架構。

系統會為每個屬性分配特定數量的查詢資源權杖。API 用戶端可以在 API 要求中新增選填欄位，以獲得更高的取樣門檻，以換取相對查詢資源權杖。運算成本較高的要求，需要更多符記。

取樣門檻

使用 Google Analytics (分析) API v4 的資料要求必須符合以下一般的取樣門檻 (以資源層級所要求日期範圍的工作階段數為準)：

Analytics (分析) 標準版：50 萬個工作階段
Analytics (分析) 360：1 百萬個工作階段
使用以資源為基礎的配額：1 億個工作階段

啟用以資源為基礎的配額

如要為特定要求啟用按資源計算的配額，API 呼叫必須在 batchGet 方法中加入選用欄位 useResourceQuotas。

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

例如：

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

查詢資源費用的回應欄位

每次呼叫 batchGet 方法時，回應都會有 queryCost 欄位。

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

queryCost 欄位是整數，代表 batchGet 要求中所有 ReportRequests 的資源總費用。例如：

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

配額分配

Analytics (分析) 360 資源配額

每項資源每天 100,000 次查詢費用單位。
每項資源每小時 25,000 個查詢費用單位。

如果超過配額限制，您會收到 RESOURCE_EXHAUSTED 錯誤。詳情請參閱錯誤回應。

費用計算

要求的費用與以下比例的差距：

日期範圍的大小。
資料檢視中的命中次數。
所請求維度的基數。
要求的維度和指標數量。
區隔和篩選器定義的複雜度。
所要求資訊的處理狀態 (要求今天的資料比要求昨天的資料高)。
提供「查詢時匯入」維度和指標。

API 限制和用量

除了以資源為基礎的配額系統，API 也受到 Analytics API v4 的限制與配額規範。

附註

queryCost 回應欄位代表要求的計算費用。這項 API 不需花費金錢，也免費提供 API。
無論 useResourceQuotas 設定為何，當日報表和特定歷來資料 (1 歲以上) 報表可能還是必須進行取樣。
如果要求無法滿足更高的取樣門檻，系統就不會扣除資源配額權杖 (取樣回應的資源配額一律為零)。
如果回應中有 samplesReadCounts 和 samplingSpaceSizes 欄位，報表就會包含取樣資料。

如要查看或變更專案的用量限制，或是想申請更多配額，請進行以下步驟：

確認您的專案已設有帳單帳戶。如果沒有，請先建立一個。
開啟 API 控制台並前往 API 程式庫「已啟用的 API」頁面，從清單中選取 API。
如要查看及變更配額相關設定，請點選「配額」。如要查看用量統計資料，請點選「用量」。