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)

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

DimensionExpression

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

ייצוג JSON
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
שדות
שדה איחוד one_expression. יש לציין סוג אחד של ביטוי מאפיין עבור DimensionExpression. one_expression יכול להיות רק אחד מהבאים:
lowerCase

object (CaseExpression)

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

upperCase

object (CaseExpression)

משמש להמרת ערך של מאפיין לאותיות רישיות.

concatenate

object (ConcatenateExpression)

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

CaseExpression

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

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

string

שם של מאפיין. השם חייב להתייחס לשם בשדה המימדים של הבקשה.

ConcatenateExpression

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

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

string

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

delimiter

string

התו המפריד בין שמות המאפיינים.

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