OrderBy

排序依據會定義回應中的資料列排序方式。舉例來說，依事件計數遞減排序資料列是一種排序方式，依事件名稱字串排序資料列則是另一種排序方式。

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 系統會先將維度值轉換為數字，再進行排序。舉例來說，在「數值」排序中，「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

只有在具名維度為這個值時，才排序。