Dimension

המאפיינים הם מאפייני הנתונים. לדוגמה, המאפיין 'עיר' מציין את העיר שממנה הגיע האירוע. ערכי המאפיינים בתגובות לדוח הם מחרוזות. לדוגמה, העיר יכולה להיות 'פריז' או 'ניו יורק'. אפשר להשתמש בעד 9 מאפיינים בבקשות.

ייצוג JSON
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
שדות
name

string

שם המאפיין. במאמר מאפייני API מופיעה רשימה של שמות המאפיינים שנתמכים בשיטות הליבה של הדיווח, כמו runReport ו-batchRunReports. במאמר מאפיינים בזמן אמת מופיעה רשימה של שמות המאפיינים שנתמכים בשיטה runRealtimeReport. במאמר מאפייני משפך מופיעה רשימה של שמות המאפיינים שנתמכים על ידי השיטה runFunnelReport.

אם מציינים את dimensionExpression, ‏ name יכול להיות כל מחרוזת שרוצים מתוך קבוצת התווים המותרת. לדוגמה, אם dimensionExpression הוא שרשור של country ושל city, אפשר לקרוא למאפיין הזה countryAndCity. שמות המאפיינים שבוחרים צריכים להתאים לביטוי הרגולרי ^[a-zA-Z0-9_]$.

המידות מוזכרות ב-name ב-dimensionFilter, ב-orderBys, ב-dimensionExpression וב-pivots.

dimensionExpression

object (DimensionExpression)

מאפיין אחד יכול להיות התוצאה של ביטוי של כמה מאפיינים. לדוגמה, המאפיין 'מדינה, עיר': concatenate(country, ", ", city).

DimensionExpression

המאפיין הזה משמש לציון מימד שהוא תוצאה של נוסחה של כמה מימדים. שימושים לדוגמה: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).

ייצוג JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of mutually exclusive fields.
}
שדות
מציינים סוג אחד של ביטוי מאפיין ל-DimensionExpression. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
lowerCase

object (CaseExpression)

הפונקציה משמשת להמרה של ערך מאפיין לאותיות קטנות.

upperCase

object (CaseExpression)

הפונקציה משמשת להמרת ערך של מימד לאותיות רישיות.

concatenate

object (ConcatenateExpression)

משמש לשילוב ערכי מאפיינים למאפיין יחיד. לדוגמה, המאפיין 'מדינה, עיר': concatenate(country, ", ", city).

סוף השדות הבלעדיים.

CaseExpression

משמש להמרת ערך של מימד לאותיות קטנות או גדולות.

ייצוג JSON
{
  "dimensionName": string
}
שדות
dimensionName

string

השם של מאפיין. השם חייב להיות זהה לשם שמופיע בשדה המאפיינים של הבקשה.

ConcatenateExpression

משמש לשילוב ערכי מאפיינים למאפיין יחיד.

ייצוג JSON
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
שדות
dimensionNames[]

string

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

delimiter

string

תוחם שמוצב בין שמות המאפיינים.

תווים מפרידים הם לרוב תווים בודדים כמו '|' או ',', אבל הם יכולים להיות מחרוזות ארוכות יותר. אם ערך של מאפיין מכיל את התו שמגדיר את סוף השורה, שניהם יופיעו בתשובה ללא הבחנה. לדוגמה, אם הערך של מאפיין 1 הוא US,FR, הערך של מאפיין 2 הוא JP והתו המפריד הוא , התשובה תכיל את הערך US,FR,JP.