OrderBy

排序依据定义了响应中的行排序方式。例如,按事件数降序对行进行排序,按事件名称字符串对行排序是一种不同的排序。

JSON 表示法
{
  "desc": boolean,

  // Union field one_order_by can be only one of the following:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  },
  "pivot": {
    object (PivotOrderBy)
  }
  // End of list of possible types for union field one_order_by.
}
字段
desc

boolean

如果为 true,则按降序排序。

联合字段 one_order_by。为 OrderBy 指定一种排序依据类型。one_order_by 只能是下列其中一项:
metric

object (MetricOrderBy)

按指标值对结果进行排序。

dimension

object (DimensionOrderBy)

按维度值对结果进行排序。

pivot

object (PivotOrderBy)

按数据透视列组中的指标值对结果进行排序。

MetricOrderBy

按指标值排序。

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

string

排序依据请求中的指标名称。

DimensionOrderBy

按维度值排序。

JSON 表示法
{
  "dimensionName": string,
  "orderType": enum (OrderType)
}
字段
dimensionName

string

排序依据的请求中的维度名称。

orderType

enum (OrderType)

控制维度值排序规则。

OrderType

字符串维度值排序规则。

枚举
ORDER_TYPE_UNSPECIFIED 未指定。
ALPHANUMERIC 按 Unicode 代码点排序的字母数字。例如,"2"<“A”<“X”<“b”<"z"。
CASE_INSENSITIVE_ALPHANUMERIC 按小写 Unicode 代码点排序的字母数字(不区分大小写)。例如,"2"<“A”<“b”<“X”<"z"。
NUMERIC 维度值会在排序前转换为数字。例如,在排序依据为 NUMERIC 时:“25”<“100”;在 ALPHANUMERIC 中,排序依据为“100”<“25”。非数字维度值在所有数值下方均具有相同的排序值。

PivotOrderBy

按数据透视列组排序。

JSON 表示法
{
  "metricName": string,
  "pivotSelections": [
    {
      object (PivotSelection)
    }
  ]
}
字段
metricName

string

在排序依据的响应中,按此列对行进行排序。必须是请求中的指标名称。

pivotSelections[]

object (PivotSelection)

用于选择维度名称和值透视。如果指定了多个数据透视选项,则所有数据透视选择维度名称和值对都与相应行的维度名称和值对相匹配时,系统会对相应行进行排序。

PivotSelection

一对维度名称和值。包含此维度数据透视对的行会按指标的值排序。

例如,如果 pivots = ('browser', 'Chrome') 且 metricName = "Sessions",那么系统将根据 Chrome 中的会话数对行进行排序。

---------|----------|----------------|----------|----------------
         |  Chrome  |    Chrome      |  Safari  |     Safari
---------|----------|----------------|----------|----------------
 Country | Sessions | Pages/Sessions | Sessions | Pages/Sessions
---------|----------|----------------|----------|----------------
    US   |    2     |       2        |     3    |        1
---------|----------|----------------|----------|----------------
  Canada |    3     |       1        |     4    |        1
---------|----------|----------------|----------|----------------
JSON 表示法
{
  "dimensionName": string,
  "dimensionValue": string
}
字段
dimensionName

string

必须是请求中的维度名称。

dimensionValue

string

仅当指定维度为此值时排序。