Method: reports.batchGet

מחזירה את נתוני Analytics.

בקשת HTTP

POST https://analyticsreporting.googleapis.com/v4/reports:batchGet

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "reportRequests": [
    {
      object(ReportRequest)
    }
  ],
  "useResourceQuotas": boolean
}
שדות
reportRequests[]

object(ReportRequest)

לבקשות, לכל בקשה תהיה תגובה נפרדת. אפשר לשלוח עד 5 בקשות. כל הבקשות צריכות לכלול את אותם פריטי dateRanges, viewId, segments, samplingLevel ו-cohortGroup.

useResourceQuotas

boolean

מפעיל מכסות מבוססות-משאבים, (ברירת המחדל היא False). אם השדה הזה מוגדר ל-True, המכסות לצפייה (פרופיל) כפופות לעלות החישובית של הבקשה. לתשומת ליבכם: שימוש במכסות מבוססות-עלות יאפשר שיעורי דגימה גבוהים יותר. (10 מיליון בSMALL, 100 מיליון בLARGE. פרטים נוספים זמינים במסמכי התיעוד בנושא מגבלות ומכסות.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

מחלקת התגובה הראשית שמכילה את הדוחות מהקריאה ל-batchGet של Reporting API.

ייצוג JSON 
{
  "reports": [
    {
      object(Report)
    }
  ],
  "queryCost": number,
  "resourceQuotasRemaining": {
    object(ResourceQuotasRemaining)
  }
}
שדות
reports[]

object(Report)

תשובות שמתאימות לכל אחת מהבקשות.

queryCost

number

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

resourceQuotasRemaining

object(ResourceQuotasRemaining)

הכמות של מכסת המשאבים שנותרה בנכס.

היקפי ההרשאות

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

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

ReportRequest

מחלקת הבקשה הראשית שמציינת את בקשת Reporting API.

ייצוג JSON 
{
  "viewId": string,
  "dateRanges": [
    {
      object(DateRange)
    }
  ],
  "samplingLevel": enum(Sampling),
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "metricFilterClauses": [
    {
      object(MetricFilterClause)
    }
  ],
  "filtersExpression": string,
  "orderBys": [
    {
      object(OrderBy)
    }
  ],
  "segments": [
    {
      object(Segment)
    }
  ],
  "pivots": [
    {
      object(Pivot)
    }
  ],
  "cohortGroup": {
    object(CohortGroup)
  },
  "pageToken": string,
  "pageSize": number,
  "includeEmptyRows": boolean,
  "hideTotals": boolean,
  "hideValueRanges": boolean
}
שדות
viewId

string

מזהה התצוגה המפורטת ב-Analytics שממנו יש לאחזר נתונים. כל ReportRequest במסגרת שיטת batchGet חייבת להכיל את אותו viewId.

dateRanges[]

object(DateRange)

טווחי התאריכים בבקשה. הבקשה יכולה לכלול עד 2 טווחי תאריכים. התשובה תכיל קבוצה של ערכי מדדים לכל שילוב של המאפיינים עבור כל טווח תאריכים בבקשה. כך, אם קיימים שני טווחי תאריכים, תתבצע שתי קבוצות של ערכי מדדים, אחת לטווח התאריכים המקורי והשנייה לטווח התאריכים השני. אין לציין את השדה reportRequest.dateRanges עבור קבוצות בעלות מאפיינים משותפים או בקשות של ערך חיי המשתמש. אם לא צוין טווח תאריכים, טווח התאריכים המוגדר כברירת מחדל הוא (startDate: התאריך הנוכחי - 7 ימים, endDate: התאריך הנוכחי - יום אחד). כל ReportRequest במסגרת שיטת batchGet חייבת להכיל את אותה הגדרה של dateRanges.

samplingLevel

enum(Sampling)

גודל המדגם הרצוי של הדוח. אם לא צוין השדה samplingLevel, ייעשה שימוש ברמת הדגימה DEFAULT. כל ReportRequest במסגרת שיטת batchGet חייבת להכיל את אותה הגדרה של samplingLevel. פרטים נוספים זמינים במדריך למפתחים.

dimensions[]

object(Dimension)

המאפיינים המבוקשים. לבקשות יכולים להיות 9 מאפיינים בסך הכול.

dimensionFilterClauses[]

object(DimensionFilterClause)

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

metrics[]

object(Metric)

המדדים המבוקשים. בבקשות חייבות לציין לפחות מדד אחד. הבקשות יכולות לכלול עד 10 מדדים.

metricFilterClauses[]

object(MetricFilterClause)

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

filtersExpression

string

מסננים של מאפיינים או מדדים שמגבילים את הנתונים המוחזרים עבור הבקשה שלכם. כדי להשתמש במאפיין filtersExpression, מציינים מאפיין או מדד שלפיו רוצים לסנן, ואחריהם ביטוי הסינון. לדוגמה, הביטוי הבא בוחר במאפיין ga:browser שמתחיל ב-Firefox; ga:browser=~^Firefox. מידע נוסף על מסננים של מאפיינים ומדדים זמין בחומר העזר בנושא מסננים.

orderBys[]

object(OrderBy)

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

segments[]

object(Segment)

מפלחים את הנתונים שהוחזרו עבור הבקשה. הגדרת פלח עוזרת לבחון קבוצת משנה של בקשת הפלח. בקשה יכולה להכיל עד ארבעה קטעים. כל ReportRequest במסגרת שיטת batchGet חייבת להכיל את אותה הגדרה של segments. בקשות עם פלחים חייבות לכלול את המאפיין ga:segment.

pivots[]

object(Pivot)

הגדרות הציר. לבקשות יכולים להיות עד 2 צירים.

cohortGroup

object(CohortGroup)

קבוצה בעלת מאפיינים משותפים שמשויכת לבקשה הזו. אם יש בבקשה קבוצה בעלת מאפיינים משותפים, המאפיין ga:cohort חייב להיכלל בבקשה. כל ReportRequest במסגרת שיטת batchGet חייבת להכיל את אותה הגדרה של cohortGroup.

pageToken

string

אסימון המשך לקבלת הדף הבא של התוצאות. הוספת הפרמטר הזה לבקשה תחזיר את השורות שאחרי ה-pageToken. ה-pageToken צריך להיות הערך שהוחזר בפרמטר nextPageToken בתגובה לבקשה Reports.batchGet.

pageSize

number

גודל הדף מיועד לדפים, ומציין את המספר המקסימלי של שורות שהוחזרו. גודל הדף צריך להיות >= 0. שאילתה מחזירה את ברירת המחדל של 1,000 שורות. ממשק ה-API הראשי לדיווח של Analytics מחזיר עד 100,000 שורות לבקשה, ללא קשר לכמות שתבקש. הוא יכול גם להחזיר פחות שורות ממה שביקשת, אם אין מספיק פלחי מאפיינים ממה שציפיתם. לדוגמה, יש פחות מ-300 ערכים אפשריים למאפיין ga:country, לכן כשמפלחים רק לפי מדינה לא ניתן לקבל יותר מ-300 שורות, גם אם מגדירים ל-pageSize ערך גבוה יותר.

includeEmptyRows

boolean

אם הערך מוגדר כ-False, התשובה לא תכלול שורות אם כל המדדים שאוחזרו שווים לאפס. ברירת המחדל היא FALSE, שתחריג את השורות האלה.

hideTotals

boolean

אם היא מוגדרת כ-True, המערכת מסתירה את סך כל המדדים בכל השורות התואמות, בכל טווח תאריכים. ערך ברירת המחדל False ויחזיר את הסכומים הכוללים.

hideValueRanges

boolean

אם קובעים את ההגדרה True, המערכת מסתירה את ערכי המינימום והמקסימום בכל השורות התואמות. ברירת המחדל היא False וטווחי הערכים מוחזרים.

דגימות

ערכים של רמת הדגימה.

טיפוסים בני מנייה (enums)
SAMPLING_UNSPECIFIED אם לא צוין השדה samplingLevel, ייעשה שימוש ברמת הדגימה DEFAULT.
DEFAULT הפונקציה מחזירה תגובה בגודל דגימה שמאזן את המהירות והדיוק.
SMALL התוצאה היא תגובה מהירה עם דגימה קטנה יותר.
LARGE מחזירה תגובה מדויקת יותר באמצעות דגימה גדולה. עם זאת, ייתכן שכתוצאה מכך התגובה תהיה איטית יותר.

המאפיין

מאפיינים הם מאפייני הנתונים. לדוגמה, המאפיין ga:city מציין את העיר, למשל, פריז או ניו יורק, שממנה הגיע הביקור באתר.

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

string

שם המאפיין שרוצים לאחזר, לדוגמה ga:browser.

histogramBuckets[]

string (int64 format)

אם השדה לא ריק, אנחנו מציבים את ערכי המאפיינים בקטגוריות אחרי המחרוזת ל-int64. ערכי מאפיין שאינם ייצוג המחרוזת של ערך אינטגרלי יומרו לאפס. ערכי הקטגוריה חייבים להיות בסדר עולה. כל קטגוריה סגורה בקצה התחתון ופתוחה בקצה העליון. הקטגוריה "first" כוללת את כל הערכים פחות מהגבול הראשון, הקטגוריה "האחרונה" כוללת את כל הערכים עד אינסוף. ערכי מאפיינים שנכללים בקטגוריה משתנים לערך חדש של מאפיין. לדוגמה, אם מוצגת רשימה של '0, 1, 3, 4, 7', נחזיר את הקטגוריות הבאות:

  • קטגוריה מס' 1: ערכים < 0, ערך המאפיין '<0'
  • קטגוריה מס' 2: ערכים ב-[0,1), ערך המאפיין '0'
  • קטגוריה מס' 3: ערכים ב-[1,3), ערך המאפיין '1-2'
  • קטגוריה מס' 4: ערכים ב-[3,4), ערך המאפיין '3'
  • קטגוריה מס' 5: ערכים בטווח [4,7), ערך המאפיין '4-6'
  • קטגוריה מס' 6: ערכים >= 7, ערך המאפיין "7+"

הערה: אם מחילים מוטציה של היסטוגרמה על מימד כלשהו ומשתמשים במאפיין הזה במיון, צריך להשתמש בסוג המיון HISTOGRAM_BUCKET למטרה הזו. אחרת, ערכי המאפיינים ימוינו לפי סדר המילון (לקסיקוגרפי). לדוגמה, הסדר במילון בסדר עולה הוא:

'<50', '1001+', '121-1000', '50-120'

והסדר עולה של HISTOGRAM_BUCKET הוא:

"<50", "50-120", "121-1000", "1001+"

הלקוח צריך לבקש במפורש "orderType": "HISTOGRAM_BUCKET" למאפיין שעבר שינוי בהיסטוגרמה.

DimensionFilterClause

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

ייצוג JSON 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(DimensionFilter)
    }
  ]
}
שדות
operator

enum(FilterLogicalOperator)

האופרטור לשילוב של כמה מסנני מאפיינים. אם לא צוין, הוא נחשב כ-OR.

filters[]

object(DimensionFilter)

קבוצת המסננים החוזרת. הם משולבים באופן לוגי בהתאם לאופרטור שצוין.

FilterLogicalOperator

האופן שבו המסננים משולבים באופן לוגי.

טיפוסים בני מנייה (enums)
OPERATOR_UNSPECIFIED אופרטור לא צוין. הוא נחשב OR.
OR האופרטור הלוגי OR.
AND האופרטור הלוגי AND.

DimensionFilter

מסנן המאפיינים מציין את אפשרויות הסינון של מאפיין.

ייצוג JSON 
{
  "dimensionName": string,
  "not": boolean,
  "operator": enum(Operator),
  "expressions": [
    string
  ],
  "caseSensitive": boolean
}
שדות
dimensionName

string

המאפיין שלפיו רוצים לסנן. DimensionsFilter חייב להכיל מאפיין.

not

boolean

אופרטור לוגי NOT. אם הערך הבוליאני מוגדר כ-True, ערכי המאפיינים התואמים יוחרגו מהדוח. ברירת המחדל היא False.

operator

enum(Operator)

איך להתאים את המאפיין לביטוי. ברירת המחדל היא REGEXP.

expressions[]

string

מחרוזות או ביטוי רגולרי להתאמה. רק הערך הראשון ברשימה ישמש להשוואה, אלא אם האופרטור הוא IN_LIST. אם האופרטור IN_LIST, הרשימה כולה משמשת לסינון המאפיינים כמו שמוסבר בתיאור של האופרטור IN_LIST.

caseSensitive

boolean

האם ההתאמה צריכה להיות תלוית אותיות רישיות? ברירת המחדל היא False.

מפעיל

סוגי התאמה שונים נתמכים.

טיפוסים בני מנייה (enums)
OPERATOR_UNSPECIFIED אם סוג ההתאמה לא צוין, הוא יטופל כ-REGEXP.
REGEXP הביטוי של ההתאמה נחשב לביטוי רגולרי. לא כל סוגי ההתאמה מטופלים כביטויים רגולריים.
BEGINS_WITH תואם לערך שמתחיל בביטוי ההתאמה שצוין.
ENDS_WITH תואם לערכים שמסתיימים בביטוי ההתאמה שסופק.
PARTIAL התאמה למחרוזת משנה.
EXACT הערך צריך להיות תואם באופן מלא לביטוי ההתאמה.
NUMERIC_EQUAL

מסננים להשוואה של מספרים שלמים. המערכת מתעלמת מהתלות של אותיות רישיות (case-sensitivity) בהגדרות האלה, והביטוי נחשב למחרוזת שמייצגת מספר שלם. התנאים לכשל:

  • אם הביטוי אינו int64 חוקי, הלקוח אמור לצפות לשגיאה.
  • מאפייני קלט שהם לא ערכי int64 חוקיים אף פעם לא יתאימו למסנן.
NUMERIC_GREATER_THAN בודקת אם המאפיין גדול המספר מבחינה מספרית מביטוי ההתאמה. צריך לקרוא את התיאור של NUMERIC_EQUALS למידע על ההגבלות.
NUMERIC_LESS_THAN בודקת אם המאפיין קטן המספר מבחינה מספרית מביטוי ההתאמה. צריך לקרוא את התיאור של NUMERIC_EQUALS למידע על ההגבלות.
IN_LIST

אפשרות זו משמשת לציון מסנן מאפיינים שהביטוי שלו יכול לקבל כל ערך מרשימת ערכים נבחרת. כך תוכלו להימנע מהערכה של כמה מסננים של מאפיינים בהתאמה מדויקת, שהמערכת בודקת אם מופעלת בהם האופרטור OR בכל שורת תגובה. למשל:

expressions: ["A", "B", "C"]

כל שורת תגובה שהמאפיין הזה כולל את הערך א', ב' או ג', תואמת ל'מסנן המאפיין' הזה.

המדד

מדדים הם האומדנים הכמותיים. לדוגמה, המדד ga:users מציין את המספר הכולל של המשתמשים בתקופת הזמן המבוקשת.

ייצוג JSON 
{
  "expression": string,
  "alias": string,
  "formattingType": enum(MetricType)
}
שדות
expression

string

ביטוי של מדד בבקשה. ביטוי מורכב ממספר אחד או יותר וממדד אחד או יותר. האופרטורים שבהם אפשר להשתמש כוללים את סימן הפלוס (+), מינוס (-), השלילה (Unary -), חילוק ב- (/), הכפלה ב- (*), סוגריים, מספרים קרדינלים חיוביים (0-9). האופרטורים יכולים לכלול ספרות אחרי הנקודה העשרונית ומוגבל ל-1024 תווים. לדוגמה ga:totalRefunds/ga:users, ברוב המקרים ביטוי המדד הוא רק שם של מדד יחיד, כמו ga:users. מתבצעת הוספה של MetricType מעורבים (למשל, המדדים CURRENCY + PERCENTAGE) יגרמו לתוצאות בלתי צפויות.

alias

string

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

formattingType

enum(MetricType)

מציין את הפורמט של ביטוי המדד, לדוגמה INTEGER.

MetricType

סוגי המדדים.

טיפוסים בני מנייה (enums)
METRIC_TYPE_UNSPECIFIED לא צוין סוג המדד.
INTEGER מדד מסוג מספר שלם.
FLOAT מדד צף.
CURRENCY מדד מטבע.
PERCENT אחוז.
TIME מדד זמן בפורמט HH:MM:SS.

MetricFilterClause

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

ייצוג JSON 
{
  "operator": enum(FilterLogicalOperator),
  "filters": [
    {
      object(MetricFilter)
    }
  ]
}
שדות
operator

enum(FilterLogicalOperator)

האופרטור לשילוב מסננים של כמה מדדים. אם לא צוין, הוא נחשב כ-OR.

filters[]

object(MetricFilter)

קבוצת המסננים החוזרת. הם משולבים באופן לוגי בהתאם לאופרטור שצוין.

MetricFilter

הערך MetricFilter מציין את המסנן של המדד.

ייצוג JSON 
{
  "metricName": string,
  "not": boolean,
  "operator": enum(Operator),
  "comparisonValue": string
}
שדות
metricName

string

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

not

boolean

אופרטור לוגי NOT. אם הערך הבוליאני מוגדר כ-True, ערכי המדדים התואמים יוחרגו מהדוח. ברירת המחדל היא False.

operator

enum(Operator)

האם המדד EQUAL, LESS_THAN או GREATER_THAN הוא CompareValue. ברירת המחדל היא EQUAL. אם האופרטור הוא IS_MISSING, בודק אם המדד חסר והמערכת מתעלמת מ-ComparisonValue.

comparisonValue

string

הערך שאליו יש להשוות.

מפעיל

אפשרויות שונות של סוגי השוואה.

טיפוסים בני מנייה (enums)
OPERATOR_UNSPECIFIED אם האופרטור לא צוין, המערכת תתייחס אליו בתור EQUAL.
EQUAL האם ערך המדד צריך להיות שווה בדיוק לערך ההשוואה.
LESS_THAN האם ערך המדד צריך להיות נמוך מערך ההשוואה.
GREATER_THAN האם ערך המדד צריך להיות גדול מערך ההשוואה.
IS_MISSING הפונקציה בודקת אם המדד חסר. לא נלקחת בחשבון השוואה של ValueValue.

OrderBy

מציין את אפשרויות המיון.

ייצוג JSON 
{
  "fieldName": string,
  "orderType": enum(OrderType),
  "sortOrder": enum(SortOrder)
}
שדות
fieldName

string

השדה שלפיו רוצים למיין. סדר המיון שמוגדר כברירת מחדל הוא בסדר עולה. דוגמה: ga:browser הערה: אפשר לציין כאן רק שדה אחד למיון. לדוגמה, הערך ga:browser, ga:city אינו חוקי.

orderType

enum(OrderType)

סוג ההזמנה. ערך ברירת המחדל של orderType הוא VALUE.

sortOrder

enum(SortOrder)

סדר המיון של השדה.

OrderType

OrderType קובע איך נקבע סדר המיון.

טיפוסים בני מנייה (enums)
ORDER_TYPE_UNSPECIFIED סוג הזמנה שלא צוין יטופל כמיון המבוסס על ערך.
VALUE סדר המיון מבוסס על הערך בעמודה שנבחרה. הוא מתייחס רק לטווח התאריכים הראשון.
DELTA סדר המיון מבוסס על ההפרש בין הערכים בעמודה שנבחרה משני טווחי התאריכים הראשונים. ניתן להשתמש רק אם יש שני טווחי תאריכים בדיוק.
SMART סדר המיון מבוסס על הערך המשוקלל של העמודה שנבחרה. אם לעמודה יש פורמט n/d, אפשר יהיה להשתמש בערך המשוקלל של היחס הזה (n + totals.n)/(d + totals.d) רק עבור מדדים שמייצגים יחסים.
HISTOGRAM_BUCKET סוג סדר ההיסטוגרמה רלוונטי רק לעמודות מימדים עם קטגוריות היסטוגרמה שאינן ריקות.
DIMENSION_AS_INTEGER אם הממדים הם מספרים באורך קבוע, מיון רגיל יפעל בצורה תקינה. אפשר להשתמש בפונקציה DIMENSION_AS_INTEGER אם המאפיינים הם מספרים באורך משתנה.

SortOrder

סדר המיון של המיון.

טיפוסים בני מנייה (enums)
SORT_ORDER_UNSPECIFIED אם סדר המיון לא צוין, ברירת המחדל היא עולה.
ASCENDING מיון בסדר עולה. השדה ימוין בסדר עולה.
DESCENDING מיון בסדר יורד. השדה ימוין בסדר יורד.

פילוח

הגדרת הפלח, אם צריך לפלח את הדוח. פלח הוא קבוצת משנה של נתונים ב-Google Analytics. לדוגמה, מתוך קבוצה כוללת של משתמשים, אפשר ליצור פלח של משתמשים מעיר או ממדינה מסוימות.

ייצוג JSON 
{

  // Union field dynamicOrById can be only one of the following:
  "dynamicSegment": {
    object(DynamicSegment)
  },
  "segmentId": string
  // End of list of possible types for union field dynamicOrById.
}
שדות
שדה איחוד dynamicOrById. אפשר להגדיר את הפלח באופן דינמי באמצעות פילוח דינמי או על ידי שימוש במזהה של פלח מובנה או פלח מותאם אישית. dynamicOrById יכול להיות רק אחד מהבאים:
dynamicSegment

object(DynamicSegment)

הגדרת פלח דינמי בבקשה.

segmentId

string

מזהה הפלח של פלח מובנה או פלח בהתאמה אישית, לדוגמה gaid::-3.

DynamicSegment

הגדרת פלח דינמי להגדרת הפלח בתוך הבקשה. פלח יכול לבחור משתמשים, ביקורים או את שניהם.

ייצוג JSON 
{
  "name": string,
  "userSegment": {
    object(SegmentDefinition)
  },
  "sessionSegment": {
    object(SegmentDefinition)
  }
}
שדות
name

string

שם הפלח הדינמי.

userSegment

object(SegmentDefinition)

פלח משתמשים כדי לבחור משתמשים שייכללו בפלח.

sessionSegment

object(SegmentDefinition)

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

SegmentDefinition

הגדרת פלח מגדירה את הפלח כקבוצה של מסנני פלח שמשולבים יחד עם פעולת AND לוגית.

ייצוג JSON 
{
  "segmentFilters": [
    {
      object(SegmentFilter)
    }
  ]
}
שדות
segmentFilters[]

object(SegmentFilter)

פלח מוגדר באמצעות קבוצה של מסנני פלחים שמשולבים יחד עם פעולת AND לוגית.

SegmentFilter

segmentFilter מגדיר את הפלח כפלח פשוט או כפלח של רצף. תנאי פשוט לפלח מכיל תנאים של מאפיינים ומדדים לבחירת הסשנים או המשתמשים. תנאי של פלח רצף יכול לשמש לבחירת משתמשים או סשנים על סמך תנאים רציפים.

ייצוג JSON 
{
  "not": boolean,

  // Union field simpleOrSequence can be only one of the following:
  "simpleSegment": {
    object(SimpleSegment)
  },
  "sequenceSegment": {
    object(SequenceSegment)
  }
  // End of list of possible types for union field simpleOrSequence.
}
שדות
not

boolean

אם הערך הוא True, יש להתאים את ההשלמה של מקטע פשוט או קטע רצף. לדוגמה, כדי להתאים את כל הביקורים שמקורם ב "ניו יורק", נוכל להגדיר את הפלח באופן הבא:

  "sessionSegment": {
    "segmentFilters": [{
      "simpleSegment" :{
        "orFiltersForSegment": [{
          "segmentFilterClauses":[{
            "dimensionFilter": {
              "dimensionName": "ga:city",
              "expressions": ["New York"]
            }
          }]
        }]
      },
      "not": "True"
    }]
  },

שדה איחוד simpleOrSequence. האם זה מקטע פשוט או הגדרה של פלח רצף. simpleOrSequence יכול להיות רק אחד מהבאים:
simpleSegment

object(SimpleSegment)

תנאי פילוח פשוטים כוללים תנאי אחד או יותר של מאפיין/מדד, שניתן לשלב

sequenceSegment

object(SequenceSegment)

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

SimpleSegment

תנאי פילוח פשוטים כוללים תנאי אחד או יותר של מאפיין/מדד, שניתן לשלב.

ייצוג JSON 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ]
}
שדות
orFiltersForSegment[]

object(OrFiltersForSegment)

רשימה של קבוצות של מסנני פלחים שמשולבות עם האופרטור הלוגי AND.

OrFiltersForSegment

רשימה של מסנני פלחים בקבוצה OR משולבת עם האופרטור הלוגי OR.

ייצוג JSON 
{
  "segmentFilterClauses": [
    {
      object(SegmentFilterClause)
    }
  ]
}
שדות
segmentFilterClauses[]

object(SegmentFilterClause)

רשימת מסנני פלחים לשילוב עם אופרטור OR.

SegmentFilterClause

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

ייצוג JSON 
{
  "not": boolean,

  // Union field dimensionOrMetricFilter can be only one of the following:
  "dimensionFilter": {
    object(SegmentDimensionFilter)
  },
  "metricFilter": {
    object(SegmentMetricFilter)
  }
  // End of list of possible types for union field dimensionOrMetricFilter.
}
שדות
not

boolean

תואם להשלמה (!) של המסנן.

שדה איחוד dimensionOrMetricFilter. מסנן של מאפיינים או מדדים. dimensionOrMetricFilter יכול להיות רק אחד מהבאים:
dimensionFilter

object(SegmentDimensionFilter)

מסנן מאפיינים להגדרת הפלח.

metricFilter

object(SegmentMetricFilter)

מסנן מדדים להגדרת הפלח.

SegmentDimensionFilter

מסנן המאפיינים מציין את אפשרויות הסינון של מאפיין.

ייצוג JSON 
{
  "dimensionName": string,
  "operator": enum(Operator),
  "caseSensitive": boolean,
  "expressions": [
    string
  ],
  "minComparisonValue": string,
  "maxComparisonValue": string
}
שדות
dimensionName

string

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

operator

enum(Operator)

האופרטור שבו יש להשתמש כדי להתאים את המאפיין לביטויים.

caseSensitive

boolean

אם ההתאמה תהיה תלוית אותיות רישיות, המערכת תתעלם מאופרטור IN_LIST.

expressions[]

string

רשימת הביטויים, רק הרכיב הראשון משמש לכל האופרטורים

minComparisonValue

string

ערכי השוואה מינימליים לסוג התאמה אחד (BETWEEN).

maxComparisonValue

string

ערכי השוואה מקסימליים עבור סוג התאמה אחד (BETWEEN).

מפעיל

סוגי התאמה שונים נתמכים.

טיפוסים בני מנייה (enums)
OPERATOR_UNSPECIFIED אם סוג ההתאמה לא צוין, הוא יטופל כ-REGEXP.
REGEXP הביטוי של ההתאמה נחשב לביטוי רגולרי. כל שאר סוגי ההתאמה לא יטופלו כביטויים רגולריים.
BEGINS_WITH תואם לערכים שמתחילים בביטוי ההתאמה שסופק.
ENDS_WITH תואם לערכים שמסתיימים בביטוי ההתאמה שסופק.
PARTIAL התאמה למחרוזת משנה.
EXACT הערך צריך להיות תואם באופן מלא לביטוי ההתאמה.
IN_LIST

אפשרות זו משמשת לציון מסנן מאפיינים שהביטוי שלו יכול לקבל כל ערך מרשימת ערכים נבחרת. כך תוכלו להימנע מהערכה של כמה מסננים של מאפיינים בהתאמה מדויקת, שהמערכת בודקת אם מופעלת בהם האופרטור OR בכל שורת תגובה. למשל:

expressions: ["A", "B", "C"]

כל שורת תגובה שהמאפיין הזה כולל את הערך א', ב' או ג', תואמת ל'מסנן המאפיין' הזה.
NUMERIC_LESS_THAN

מסננים להשוואה של מספרים שלמים. המערכת מתעלמת מהתלות של אותיות רישיות (case-sensitivity) בהגדרות האלה, והביטוי נחשב למחרוזת שמייצגת מספר שלם. התנאים לכשל:

  • אם הביטוי אינו int64 חוקי, הלקוח אמור לצפות לשגיאה.
  • מאפייני קלט שהם לא ערכי int64 חוקיים אף פעם לא יתאימו למסנן.

בודקת אם המאפיין קטן המספר מבחינה מספרית מביטוי ההתאמה.
NUMERIC_GREATER_THAN בודקת אם המאפיין גדול המספר מבחינה מספרית מביטוי ההתאמה.
NUMERIC_BETWEEN בודקת אם המאפיין הוא מספרי בין המינימום והמקסימום של ביטוי ההתאמה, והגבולות לא נכללים.

SegmentMetricFilter

מסנן מדדים שישמש בתנאי סינון של פלח.

ייצוג JSON 
{
  "scope": enum(Scope),
  "metricName": string,
  "operator": enum(Operator),
  "comparisonValue": string,
  "maxComparisonValue": string
}
שדות
scope

enum(Scope)

היקף המדד מגדיר את הרמה שבה אותו מדד מוגדר. היקף המדד שצוין חייב להיות שווה להיקף הראשי או גדול ממנו, כפי שהוגדר במודל הנתונים. ההיקף הראשי מוגדר לפי בחירת המשתמשים או הסשנים בפלח.

metricName

string

המדד שלפיו יתבצע הסינון. השדה metricFilter חייב להכיל שם של מדד.

operator

enum(Operator)

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

comparisonValue

string

הערך שאליו יש להשוות. אם האופרטור הוא BETWEEN, המערכת תתייחס לערך הזה כערך השוואה מינימלי.

maxComparisonValue

string

אפשר להשתמש בערך השוואה מקסימלי רק עבור אופרטור אחד (BETWEEN).

היקף

ההיקף של המדד מגדיר את הרמה שבה המדד הזה מוגדר – PRODUCT, HIT, SESSION או USER. ניתן לדווח על ערכי מדדים גם בהיקפים גדולים יותר מההיקף הראשי שלהם. למשל: ניתן לדווח על ga:pageviews ועל ga:transactions ברמת SESSION ו-USER על ידי חיבור שלהם לכל היט שמתרחש בסשנים האלה או למשתמשים האלה.

טיפוסים בני מנייה (enums)
UNSPECIFIED_SCOPE אם לא צוין היקף, ברירת המחדל של היקף התנאי היא USER או SESSION, בהתאם להיקף שבו הפלח מנסה לבחור משתמשים או סשנים.
PRODUCT היקף המוצרים.
HIT היקף ההיט.
SESSION היקף ברמת הסשן.
USER היקף המשתמשים.

מפעיל

אפשרויות שונות של סוגי השוואה.

טיפוסים בני מנייה (enums)
UNSPECIFIED_OPERATOR אופרטור שלא צוין מטופל כאופרטור LESS_THAN.
LESS_THAN הפונקציה בודקת אם הערך של המדד נמוך מערך ההשוואה.
GREATER_THAN הפונקציה בודקת אם ערך המדד גדול מערך ההשוואה.
EQUAL שווה לאופרטור.
BETWEEN בין אופרטור, גם המינימום וגם המקסימום אינם מוגבלים. נשתמש ב-LT וב-GT לצורך השוואה.

SequenceSegment

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

ייצוג JSON 
{
  "segmentSequenceSteps": [
    {
      object(SegmentSequenceStep)
    }
  ],
  "firstStepShouldMatchFirstHit": boolean
}
שדות
segmentSequenceSteps[]

object(SegmentSequenceStep)

רשימת השלבים ברצף.

firstStepShouldMatchFirstHit

boolean

אם הוא מוגדר, התנאי של השלב הראשון חייב להתאים להתאמה הראשונה של המבקר (בטווח התאריכים).

SegmentSequenceStep

הגדרה של רצף קטעים.

ייצוג JSON 
{
  "orFiltersForSegment": [
    {
      object(OrFiltersForSegment)
    }
  ],
  "matchType": enum(MatchType)
}
שדות
orFiltersForSegment[]

object(OrFiltersForSegment)

רצף מצוין באמצעות רשימת מסננים מקובצים או מסננים שמשולבים עם האופרטור AND.

matchType

enum(MatchType)

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

MatchType

סוג ההתאמה של הרצף.

טיפוסים בני מנייה (enums)
UNSPECIFIED_MATCH_TYPE סוג התאמה שלא צוין נחשב כהתאמה קודמת.
PRECEDES האופרטור מציין שהשלב הקודם קודם לשלב הבא.
IMMEDIATELY_PRECEDES האופרטור מציין שהשלב הקודם מיד לפני השלב הבא.

ציר

הציר מתאר את הקטע שבבקשה. הציר עוזר לארגן מחדש את המידע שבדוחות מסוימים בטבלה על ידי יצירת ציר בנתונים לפי מאפיין שני.

ייצוג JSON 
{
  "dimensions": [
    {
      object(Dimension)
    }
  ],
  "dimensionFilterClauses": [
    {
      object(DimensionFilterClause)
    }
  ],
  "metrics": [
    {
      object(Metric)
    }
  ],
  "startGroup": number,
  "maxGroupCount": number
}
שדות
dimensions[]

object(Dimension)

רשימת מאפיינים להצגה כעמודות צירים. לכל ציר יכולים להיות 4 מאפיינים לכל היותר. מאפייני ציר הם חלק מההגבלה על המספר הכולל של מאפיינים שמותרים בבקשה.

dimensionFilterClauses[]

object(DimensionFilterClause)

מאפייני DimensionsFilterClauses משולבים באופן לוגי עם אופרטור AND: רק הנתונים הכלולים בכל DimensionsFilterClauses האלה תורמים לערכים באזור הצירים הזה. אפשר להשתמש במסנני מאפיינים כדי להגביל את העמודות שמוצגות באזור הצירים. לדוגמה, אם מגדירים את ga:browser כמאפיין המבוקש באזור הצירים, ואתם מציינים מסנני מפתח כדי להגביל את ga:browser ל-"IE" או ל-"Firefox" בלבד, רק שני הדפדפנים האלה יופיעו כעמודות.

metrics[]

object(Metric)

מדדי הציר. מדדי ציר הם חלק מההגבלה על המספר הכולל של המדדים שמותרים בבקשה.

startGroup

number

אם נשלחה בקשה ל-k מדדים, התגובה תכלול כמה עמודות תלויות-נתונים של k עמודות בדוח. למשל, אם תציבו בטבלת צירים את המאפיין ga:browser, יתקבלו k עמודות עבור "Firefox", k עמודות עבור "IE", k עמודות עבור "Chrome" וכו'. סדר הקבוצות של העמודות נקבע לפי סדר יורד של 'סה"כ' עבור הערך הראשון מתוך k. קשרים מקוטעים לפי סדר לקסיקוגרפי של מאפיין הציר הראשון, אחר כך בסדר לקסיקוגרפי של מאפיין הציר השני, וכן הלאה. לדוגמה, אם הסכומים הכוללים של הערך הראשון עבור Firefox , IE ו-Chrome היו 8, 2, 8, בהתאמה, סדר העמודות יהיה Chrome , Firefox , IE.

האפשרויות הבאות מאפשרות לבחור אילו מהקבוצות של k עמודות ייכללו בתגובה.
maxGroupCount

number

מציין את המספר המקסימלי של קבוצות שיוחזרו. ערך ברירת המחדל הוא 10, וגם הערך המקסימלי הוא 1,000.

CohortGroup

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

"cohortGroup": {
  "cohorts": [{
    "name": "cohort 1",
    "type": "FIRST_VISIT_DATE",
    "dateRange": { "startDate": "2015-08-01", "endDate": "2015-08-01" }
  },{
    "name": "cohort 2"
     "type": "FIRST_VISIT_DATE"
     "dateRange": { "startDate": "2015-07-01", "endDate": "2015-07-01" }
  }]
}
ייצוג JSON 
{
  "cohorts": [
    {
      object(Cohort)
    }
  ],
  "lifetimeValue": boolean
}
שדות
cohorts[]

object(Cohort)

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

lifetimeValue

boolean

הפעלת ערך חיי המשתמש (LTV). ערך חיי המשתמש מודד את ערך חיי המשתמש של משתמשים שצורפו דרך ערוצים שונים. מידע נוסף זמין בקטעים ניתוח קבוצות משתמשים וערך חיי המשתמש אם הערך של הפרמטרLTV הוא FALSE:

  • ערכי המדדים דומים לערכים בדוח על קבוצה בעלת מאפיינים משותפים בממשק האינטרנט.
  • טווחי התאריכים של ההגדרות של קבוצה בעלת מאפיינים משותפים צריכים להיות תואמים לשבוע ולחודש הקלנדריים. כלומר, אם מבקשים את הערך ga:cohortNthWeek בהגדרה של קבוצה בעלת מאפיינים משותפים, הטווח של startDate צריך להיות יום ראשון, והערך endDate צריך להיות יום שבת הבא, ועבור ga:cohortNthMonth, startDate צריך להיות היום הראשון בחודש ו-endDate צריך להיות היום האחרון בחודש.

כאשר ערך חיי המשתמש הוא TRUE:

  • ערכי המדדים יתאימו לערכים בדוח 'ערך חיי המשתמש' בממשק האינטרנט.
  • הדוח 'ערך חיי המשתמש' מראה את הגידול בערך המשתמש (הכנסה) ובמעורבות (צפיות באפליקציה, מטרות עסקיות, ביקורים ומשך הסשן) במהלך 90 הימים שאחרי צירוף משתמש.
  • המדדים מחושבים כממוצע מצטבר לכל משתמש במרווחי הזמן.
  • טווחי התאריכים של ההגדרות של קבוצה בעלת מאפיינים משותפים לא צריכים להיות תואמים לגבולות של השבוע הקלנדרי והחודש.
  • viewId חייב להיות מזהה של צפייה באפליקציה

קבוצה בעלת מאפיינים משותפים

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

ייצוג JSON 
{
  "name": string,
  "type": enum(Type),
  "dateRange": {
    object(DateRange)
  }
}
שדות
name

string

שם ייחודי של הקבוצה בעלת המאפיינים המשותפים. אם לא הוגדר שם, המערכת תיצור באופן אוטומטי ערכים cohort_[1234...].

type

enum(Type)

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

dateRange

object(DateRange)

משתמשים בקבוצה בעלת מאפיינים משותפים FIRST_VISIT_DATE. במסגרת הקבוצה הזו, נבחרים משתמשים שתאריך הביקור הראשון שלהם הוא בין תאריך ההתחלה לבין תאריך הסיום שהוגדר בטווח התאריכים. טווחי התאריכים צריכים להתאים לבקשות לקבוצה בעלת מאפיינים משותפים. אם הבקשה מכילה ga:cohortNthDay, היא צריכה להיות באורך של יום אחד בדיוק, אם ga:cohortNthWeek היא תואמת לגבול השבוע (מתחיל ביום ראשון ומסתיים ביום שבת), ועבור טווח התאריכים ga:cohortNthMonth צריך להתאים לחודש (מתחיל ביום הראשון ומסתיים ביום האחרון של החודש). על בקשות לערך חיי המשתמש אין הגבלות כאלה. אין צורך לציין טווח תאריכים בשדה reportsRequest.dateRanges.

סוג

הסוג של הקבוצה בעלת המאפיינים המשותפים.

טיפוסים בני מנייה (enums)
UNSPECIFIED_COHORT_TYPE אם לא צוין סוג, הוא יטופל כ-FIRST_VISIT_DATE.
FIRST_VISIT_DATE קבוצות בעלות מאפיינים משותפים שנבחרו על סמך תאריך הביקור הראשון.

דיווח

תגובת הנתונים שתואמת לבקשה.

ייצוג JSON 
{
  "columnHeader": {
    object(ColumnHeader)
  },
  "data": {
    object(ReportData)
  },
  "nextPageToken": string
}
שדות
columnHeader

object(ColumnHeader)

כותרות העמודות.

data

object(ReportData)

נתוני תשובות.

nextPageToken

string

אסימון דף לאחזור דף התוצאות הבא ברשימה.

ColumnHeader

כותרות עמודות.

ייצוג JSON 
{
  "dimensions": [
    string
  ],
  "metricHeader": {
    object(MetricHeader)
  }
}
שדות
dimensions[]

string

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

metricHeader

object(MetricHeader)

כותרות המדדים של המדדים בתשובה.

MetricHeader

הכותרות של המדדים.

ייצוג JSON 
{
  "metricHeaderEntries": [
    {
      object(MetricHeaderEntry)
    }
  ],
  "pivotHeaders": [
    {
      object(PivotHeader)
    }
  ]
}
שדות
metricHeaderEntries[]

object(MetricHeaderEntry)

כותרות של המדדים בתשובה.

pivotHeaders[]

object(PivotHeader)

כותרות של ה-pivots בתשובה.

MetricHeaderEntry

כותרת של המדדים.

ייצוג JSON 
{
  "name": string,
  "type": enum(MetricType)
}
שדות
name

string

שם הכותרת.

type

enum(MetricType)

סוג המדד, לדוגמה INTEGER.

PivotHeader

הכותרות של כל אחד ממקטעי הצירים המוגדרים בבקשה.

ייצוג JSON 
{
  "pivotHeaderEntries": [
    {
      object(PivotHeaderEntry)
    }
  ],
  "totalPivotGroupsCount": number
}
שדות
pivotHeaderEntries[]

object(PivotHeaderEntry)

כותרת אחת של קטע על ציר.

totalPivotGroupsCount

number

המספר הכולל של הקבוצות בטבלת הציר הזה.

PivotHeaderEntry

הכותרות של כל עמודת מדדים, שתואמות למדדים שהתבקשו בקטע הצירים של התגובה.

ייצוג JSON 
{
  "dimensionNames": [
    string
  ],
  "dimensionValues": [
    string
  ],
  "metric": {
    object(MetricHeaderEntry)
  }
}
שדות
dimensionNames[]

string

שם המאפיינים בתגובה של הצירים.

dimensionValues[]

string

הערכים של המאפיינים בציר.

metric

object(MetricHeaderEntry)

כותרת המדד של המדד בציר.

ReportData

חלק הנתונים בדוח.

ייצוג JSON 
{
  "rows": [
    {
      object(ReportRow)
    }
  ],
  "totals": [
    {
      object(DateRangeValues)
    }
  ],
  "rowCount": number,
  "minimums": [
    {
      object(DateRangeValues)
    }
  ],
  "maximums": [
    {
      object(DateRangeValues)
    }
  ],
  "samplesReadCounts": [
    string
  ],
  "samplingSpaceSizes": [
    string
  ],
  "isDataGolden": boolean,
  "dataLastRefreshed": string
}
שדות
rows[]

object(ReportRow)

לכל שילוב ייחודי של מאפיינים יש שורת ReportRow אחת.

totals[]

object(DateRangeValues)

לכל טווח תאריכים מבוקש, עבור קבוצת כל השורות שתואמות לשאילתה, כל פורמט של ערך מבוקש מקבל סכום כולל. הסכום הכולל של פורמט ערך מחושב על ידי סיכום המדדים שהוזכרו בפורמט הערך, ולאחר מכן הערכת הפורמט של הערך כביטוי סקלרי. למשל: ה'סיכומים' של 3 / (ga:sessions + 2) אנחנו מחשבים את 3 / ((sum of all relevant ga:sessions) + 2). הסכומים הכוללים מחושבים לפני העימוד.

rowCount

number

המספר הכולל של השורות התואמות לשאילתה הזו.

minimums[]

object(DateRangeValues)

ערכי המינימום והמקסימום שמוצגים בכל השורות התואמות. שתיהן ריקות אם hideValueRanges בבקשה הוא False, או כאשר rowCount הוא אפס.

maximums[]

object(DateRangeValues)

ערכי המינימום והמקסימום שמוצגים בכל השורות התואמות. שתיהן ריקות אם hideValueRanges בבקשה הוא False, או כאשר rowCount הוא אפס.

samplesReadCounts[]

string (int64 format)

אם התוצאות נדגמו, הפונקציה הזו מחזירה את המספר הכולל של הדגימות שנקראו, רשומה אחת לכל טווח תאריכים. אם התוצאות לא נדגמו, השדה הזה לא יוגדר. פרטים נוספים זמינים במדריך למפתחים.

samplingSpaceSizes[]

string (int64 format)

אם התוצאות נדגמו, הפונקציה הזו מחזירה את המספר הכולל של המדגמים הקיימים, רשומה אחת לכל טווח תאריכים. אם התוצאות לא נדגמו, השדה הזה לא יוגדר. פרטים נוספים זמינים במדריך למפתחים.

isDataGolden

boolean

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

dataLastRefreshed

string (Timestamp format)

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

חותמת זמן בפורמט 'זולו' לפי RFC3339 UTC, מדויקת לננו-שניות. דוגמה: "2014-10-02T15:01:23.045123456Z"

ReportRow

שורה בדוח.

ייצוג JSON 
{
  "dimensions": [
    string
  ],
  "metrics": [
    {
      object(DateRangeValues)
    }
  ]
}
שדות
dimensions[]

string

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

metrics[]

object(DateRangeValues)

רשימת המדדים לכל טווח תאריכים מבוקש.

DateRangeValues

משמש להחזרת רשימת מדדים של שילוב יחיד של DateRange / מאפיין

ייצוג JSON 
{
  "values": [
    string
  ],
  "pivotValueRegions": [
    {
      object(PivotValueRegion)
    }
  ]
}
שדות
values[]

string

כל ערך תואם לכל מדד בבקשה.

pivotValueRegions[]

object(PivotValueRegion)

הערכים של כל אזור ציר.

PivotValueRegion

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

ייצוג JSON 
{
  "values": [
    string
  ]
}
שדות
values[]

string

הערכים של המדדים בכל אחד מאזורי הצירים.

ResourceQuotasRemaining

האסימונים למכסת המשאבים שנותרו בנכס אחרי השלמת הבקשה.

ייצוג JSON 
{
  "dailyQuotaTokensRemaining": number,
  "hourlyQuotaTokensRemaining": number
}
שדות
dailyQuotaTokensRemaining

number

מכסת המשאבים היומית נותרת.

hourlyQuotaTokensRemaining

number

אסימונים למכסת משאבים שעתית נותרים.

רוצה לנסות?