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_]$ 匹配。

维度在 dimensionFilter、orderBys、dimensionExpression 和 pivots 中由 name 引用。
dimensionExpression

object (DimensionExpression)

一个维度可以是多个维度表达式的结果。例如，维度“国家/地区、城市”：concatenate(国家/地区, ",", 城市)。

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(国家/地区, ",", 城市)。
互斥字段的结束位置。

CaseExpression

用于将维度值转换为单一大小写。

JSON 表示法 
{
  "dimensionName": string
}
字段
dimensionName

string

维度的名称。该名称必须指回请求的维度字段中的某个名称。

ConcatenateExpression

用于将维度值合并为单个维度。

JSON 表示法 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
字段
dimensionNames[]

string

维度的名称。这些名称必须与请求的维度字段中的名称相对应。
delimiter

string

放置在维度名称之间的分隔符。

分隔符通常是单个字符，例如“|”或“,”，但也可以是较长的字符串。如果维度值包含分隔符，则响应中会同时显示这两个值，但不会区分。例如，如果维度 1 的值为“US,FR”，维度 2 的值为“JP”，分隔符为“,”，则响应将包含“US,FR,JP”。