Method: properties.runReport

{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}

object (Dimension)

要求及顯示的維度。

object (Metric)

要求及顯示的指標，

object (DateRange)

要讀取的資料日期範圍。如果要求多個日期範圍，則每個回應列都會包含以 0 為基礎的日期範圍索引。如果兩個日期範圍重疊，這兩個日期範圍的事件資料會納入這兩個日期範圍的回應列中。在同類群組要求中，不得指定這個 dateRanges。

object (FilterExpression)

維度篩選器可讓您在報表中只要求特定維度值。詳情請參閱「維度篩選器基礎知識」一文。這個篩選器無法使用指標。

object (FilterExpression)

指標的篩選器子句。與 SQL 有子句類似，在匯總報表資料列後套用。無法在這個篩選器中使用維度。

string (int64 format)

起始資料列的列數。第一列會計為第 0 列。

進行分頁時，第一個要求不會指定偏移值，或同樣地將偏移值設為 0；第一個要求會傳回資料列的前 limit。第二個要求會將偏移量設為第一個要求的 limit，第二個要求會傳回資料列的第二個 limit。

如要進一步瞭解這個分頁參數，請參閱分頁。

string (int64 format)

要傳回的列數。如果未指定，則會傳回 10,000 列。無論您要求的數量為何，API 每個要求最多只能傳回 250,000 個資料列。limit 必須為正數。

如果維度值數量不是 limit，API 傳回的資料列也會少於所要求的 limit 列數。舉例來說，「country」維度的可能值少於 300 個，因此在只針對 country 製作報表時，即使您將 limit 設為較高的值，資料最多只能顯示 300 列。

如要進一步瞭解這個分頁參數，請參閱分頁。

enum (MetricAggregation)

指標匯總。匯總指標值會顯示在 DimensionsValue 設為「RESERVED_(MetricAggregation)」的資料列中。

object (OrderBy)

指定資料列在回應中的排序方式。

string

採用 ISO4217 格式的貨幣代碼，例如「AED」、「USD」、「JPY」。如果這個欄位空白，報表會使用資源的預設貨幣。

object (CohortSpec)

與這項要求相關聯的同類群組。如果請求中有同類群組群組，就必須顯示「同類群組」維度。

boolean

如為 false 或未指定，則不會傳回所有指標等於 0 的每一列。如果設為 true，如果未遭到篩選器單獨移除，系統就會傳回這些資料列。

無論這項 keepEmptyRows 設定為何，只有 Google Analytics (分析) (GA4) 資源記錄的資料才能在報表中顯示。

舉例來說，如果資源從未記錄 purchase 事件，則 eventName 維度和 eventCount 指標查詢不會出現資料列 eventName：「purchase」和「eventCount: 0」。

boolean

切換是否要傳回這項 Analytics (分析) 資源的配額目前的狀態。系統會在 PropertyQuota 中傳回配額。