排序依据用于定义行在响应中的排序方式。例如,按事件数降序排序是指一种排序方式,而按事件名称字符串排序是指另一种排序方式。
| JSON 表示法 |
|---|
{ "desc": boolean, // Union field |
| 字段 | |
|---|---|
desc |
如果为 true,则按降序排序。 |
联合字段 one_order_by。为 OrderBy 指定一种排序依据。one_order_by 只能是下列其中一项: |
|
metric |
按指标值对结果进行排序。 |
dimension |
按维度值对结果进行排序。 |
pivot |
按数据透视列组中的指标值对结果进行排序。 |
MetricOrderBy
按指标值排序。
| JSON 表示法 |
|---|
{ "metricName": string } |
| 字段 | |
|---|---|
metric |
请求中用于排序的指标名称。 |
DimensionOrderBy
按维度值排序。
| JSON 表示法 |
|---|
{
"dimensionName": string,
"orderType": enum ( |
| 字段 | |
|---|---|
dimension |
请求中用于排序的维度名称。 |
order |
控制维度值排序的规则。 |
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 ( |
| 字段 | |
|---|---|
metric |
在排序响应中,按此列对行进行排序。必须是请求中的指标名称。 |
pivot |
用于选择维度名称和值数据透视表。如果提供了多个数据透视选择,则系统会对所有数据透视选择维度名称和值对与行维度名称和值对匹配的行进行排序。 |
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 } |
| 字段 | |
|---|---|
dimension |
必须是请求中的维度名称。 |
dimension |
仅当指定的维度为此值时才按此维度排序。 |