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

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