OrderBy

Order by 定义了响应中各行的排序方式。例如,按事件数降序对行进行排序是一种排序方式,而按事件名称字符串对行进行排序则是另一种排序方式。

JSON 表示法
{
  "desc": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  },
  "pivot": {
    object (PivotOrderBy)
  }
  // End of mutually exclusive fields.
}
字段
desc

boolean

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

OrderBy 指定一种排序依据类型。以下是互斥字段的列表。在响应中,最多只能设置一个字段:
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

仅当指定维度的值为此值时才进行排序。