Dimension

維度是資料的屬性。舉例來說，「城市」維度會指出事件的來源城市。報表回應中的維度值是字串，例如城市可以是「巴黎」或「紐約」。要求最多可包含 9 個維度。

JSON 表示法 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
欄位
name

string

維度的名稱。如需核心報表方法 (例如 runReport 和 batchRunReports) 支援的維度名稱清單，請參閱 API 維度。如需 runRealtimeReport 方法支援的維度名稱清單，請參閱「即時維度」。如需 runFunnelReport 方法支援的維度名稱清單，請參閱「漏斗維度」。

如果指定 dimensionExpression，name 可以是允許字元集內的任何字串。舉例來說，如果 dimensionExpression 會串連 country 和 city，您可以將該維度命名為 countryAndCity。您選擇的維度名稱必須符合規則運算式 ^[a-zA-Z0-9_]$。

name 會在 dimensionFilter、orderBys、dimensionExpression 和 pivots 中參照維度。
dimensionExpression

object (DimensionExpression)

一個維度可以是多個維度的運算式結果。舉例來說，維度「國家/地區、城市」：concatenate(country, ", ", city)。

DimensionExpression

用於表示多個維度公式的結果維度。使用範例：1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2)。

JSON 表示法 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of mutually exclusive fields.
}
欄位
為 DimensionExpression 指定一種維度運算式。以下列出互斥的欄位。回應中最多只會設定一個欄位：
lowerCase

object (CaseExpression)

用於將維度值轉換為小寫。
upperCase

object (CaseExpression)

將維度值轉換為大寫。
concatenate

object (ConcatenateExpression)

用於將維度值合併為單一維度。舉例來說，維度「國家/地區、城市」：concatenate(country, ", ", city)。
互斥欄位的結尾。

CaseExpression

用於將維度值轉換為單一大小寫。

JSON 表示法 
{
  "dimensionName": string
}
欄位
dimensionName

string

維度名稱。名稱必須參照要求維度欄位中的名稱。

ConcatenateExpression

用於將維度值合併為單一維度。

JSON 表示法 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
欄位
dimensionNames[]

string

維度名稱。名稱必須參照要求維度欄位中的名稱。
delimiter

string

維度名稱之間的分隔符號。

分隔符號通常是單一字元，例如「|」或「,」，但也可以是較長的字串。如果維度值包含分隔符號，回應中會同時顯示這兩者，且不會區分。舉例來說，如果維度 1 值 =「US,FR」、維度 2 值 =「JP」，且分隔符號 =「,」，則回應會包含「US,FR,JP」。