OrderBy

הסעיף Order bys מגדיר איך השורות ימוינו בתשובה. לדוגמה, סידור השורות לפי ספירת האירועים בסדר יורד הוא סידור אחד, וסידור השורות לפי מחרוזת שם האירוע הוא סידור אחר.

ייצוג 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

כלל לסידור הערכים של מאפיין מסוג מחרוזת.

טיפוסים בני מנייה (enum)
ORDER_TYPE_UNSPECIFIED לא צוין.
ALPHANUMERIC מיון אלפאנומרי לפי מיקום תו (code point) של Unicode. לדוגמה, ‏"2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC מיון אלפאנומרי לא תלוי-רישיות לפי מיקום תו (code point) ב-Unicode באותיות קטנות. לדוגמה, ‏"2" < "A" < "b" < "X" < "z".
NUMERIC ערכי המאפיינים מומרים למספרים לפני המיון. לדוגמה, במיון NUMERIC‏, '25' <‏ '100', ובמיון ALPHANUMERIC‏, '100' <‏ '25'. לכל הערכים של מאפיינים לא מספריים יש ערך סדר שווה מתחת לכל הערכים המספריים.

PivotOrderBy

מיון לפי קבוצת עמודות בטבלת צירים.

ייצוג JSON
{
  "metricName": string,
  "pivotSelections": [
    {
      object (PivotSelection)
    }
  ]
}
שדות
metricName

string

בתשובה ל-order by, השורות מסודרות לפי העמודה הזו. חייב להיות שם מדד מהבקשה.

pivotSelections[]

object (PivotSelection)

משמש לבחירת שם מאפיין וערך ציר. אם מציינים כמה בחירות של ציר, המיון מתבצע בשורות שבהן כל הצמדים של שם המאפיין וערך המאפיין של הציר תואמים לצמדים של שם המאפיין וערך המאפיין של השורה.

PivotSelection

צמד של שמות וערכים של מאפיינים. השורות עם צמד המימדים הזה מסודרות לפי ערך המדד.

לדוגמה, אם pivots = ('browser', 'Chrome') ו-metricName = "Sessions", השורות ימוינו לפי 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

הסינון לפי סדר מתבצע רק כשהערך של המאפיין שצוין הוא הערך הזה.