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 維度值會在排序前轉換為數字。舉例來說,在「數字」排序方式中,「25」<「100」,在「ALPHANUMERIC」排序方式中,「100」<「25」。非數值維度值的排序值都會低於所有數值。

PivotOrderBy

依資料透視表資料欄群組排序。

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

string

在排序回應中,依據這個欄排序資料列。必須是要求中的指標名稱。

pivotSelections[]

object (PivotSelection)

用於選取維度名稱和值樞紐。如果提供多個樞紐分析選項,系統會在所有樞紐分析選項維度名稱和值組合與列的維度名稱和值組合相符的資料列上進行排序。

PivotSelection

一組尺寸名稱和值。含有此維度樞紐組合的資料列會依據指標值排序。

舉例來說,如果樞紐 = ('browser', 'Chrome') 且指標名稱 = "工作階段",則會根據 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

只有在命名維度為此值時才排序。