Dimension

維度是資料的屬性。舉例來說，「城市」維度表示事件的來源城市。報表回應中的維度值是字串；例如城市是「巴黎」或「紐約」最多允許 9 個維度。

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

string

維度的名稱。請參閱 API 維度，瞭解 runReport 和 batchRunReports 等核心報表方法支援的維度名稱清單。請參閱「即時維度」，瞭解 runRealtimeReport 方法支援的維度名稱清單。請參閱程序維度，瞭解 runFunnelReport 方法支援的維度名稱清單。

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

「dimensionFilter」、「orderBys」、「dimensionExpression」和「pivots」中的 name 參照了維度。
dimensionExpression

object (DimensionExpression)

一個維度的成因可能是由多個維度的運算式產生。例如「國家/地區, 城市」維度：串連(國家/地區, ", ", 城市)。

DimensionExpression

用來表示由多個維度公式產生的維度。使用範例：1) lowCase(維度) 2) concatenate(dimension1, characters, dimension2)。

JSON 表示法 
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
欄位
聯集欄位 one_expression。為 DimensionExpression 指定一種維度運算式類型。one_expression 只能採用下列其中一種設定：
lowerCase

object (CaseExpression)

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

object (CaseExpression)

用來將維度值轉換為大寫。
concatenate

object (ConcatenateExpression)

用來將維度值合併至單一維度。例如「國家/地區, 城市」維度：串連(國家/地區, ", ", 城市)。

CaseExpression

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

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

string

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

ConcatenateExpression

用來將維度值合併至單一維度。

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

string

維度名稱。這些名稱必須對應到請求維度欄位中的名稱。
delimiter

string

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

分隔字元通常是單一字元，例如「|」或「,」但可以是較長的字串如果維度值包含分隔符號，系統會在回應中顯示這兩個值，但不會加以區別。舉例來說，假設維度 1 的值為「US,FR」、維度 2 值 =「JP」，且分隔符號為「,」，回應會包含「US,FR,JP」。