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

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

PivotOrderBy

يرتّب حسب مجموعة أعمدة محورية.

تمثيل JSON 
{
  "metricName": string,
  "pivotSelections": [
    {
      object (PivotSelection)
    }
  ]
}
الحقول
metricName

string

في الاستجابة لطلب الترتيب حسب، يمكنك ترتيب الصفوف حسب هذا العمود. يجب أن يكون اسم مقياس من الطلب.
pivotSelections[]

object (PivotSelection)

تُستخدَم لاختيار اسم سمة ومحور قيمة. في حال تقديم عدّة اختيارات للجدول المحوري، يتمّ الترتيب على الصفوف التي تتطابق فيها جميع أزواج اسم السمة والقيمة لاختيار الجدول المحوري مع اسم السمة والقيمة للصف.

PivotSelection

زوج من أسماء السمات وقيمها يتم ترتيب الصفوف التي تحتوي على هذا الزوج من محور السمة حسب قيمة المقياس.

على سبيل المثال، إذا كانت نقاط المحور = ('المتصفّح'، 'Chrome') وmetricName = "الجلسات"، سيتم ترتيب الصفوف استنادًا إلى "الجلسات" في 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

لا يتمّ ترتيب البيانات إلا عندما تكون السمة المُسمّاة هي هذه القيمة.