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

إذا كانت القيمة صحيحة، يتم الترتيب تنازليًا.
حدِّد نوعًا واحدًا من ترتيب النتائج حسب 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 ترتيب أبجدي رقمي غير حسّاس لحالة الأحرف حسب قيمة موضع رمز يونيكود للأحرف الصغيرة على سبيل المثال، "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

يتم الترتيب حسب فقط عندما يكون المقياس المسمّى بهذه القيمة.