הפונקציה מחזירה כמה דוחות בקבוצה. כל הדוחות צריכים להתייחס לאותו נכס GA4.
בקשת HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunReports
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
property |
מזהה של נכס GA4 ב-Google Analytics שיש מעקב אחרי האירועים שלו. מצוין בנתיב כתובת ה-URL ולא בגוף ההודעה. איפה מוצאים את מזהה הנכס? יש לציין את המאפיין הזה עבור הקבוצה. ייתכן שהנכס בתוך RunReportRequest לא מצוין או תואם לנכס הזה. דוגמה: properties/1234 |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"requests": [
{
object ( |
שדות | |
---|---|
requests[] |
בקשות אישיות. לכל בקשה יש תגובה נפרדת לדיווח. לכל בקשה באצווה יכולות להיות עד 5 בקשות. |
גוף התשובה
התגובה באצווה שמכילה כמה דוחות.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"reports": [
{
object ( |
שדות | |
---|---|
reports[] |
תשובות אישיות. לכל תגובה יש בקשת דיווח נפרדת. |
kind |
ציון סוג המשאב של ההודעה. השדה |
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunReportRequest
הבקשה להפקת דוח.
ייצוג JSON |
---|
{ "property": string, "dimensions": [ { object ( |
שדות | |
---|---|
property |
מזהה של נכס GA4 ב-Google Analytics שיש מעקב אחרי האירועים שלו. מצוין בנתיב כתובת ה-URL ולא בגוף ההודעה. איפה מוצאים את מזהה הנכס? בתוך בקשה באצווה, המאפיין הזה צריך להיות לא מוגדר או עקבי עם המאפיין ברמת אצווה. דוגמה: properties/1234 |
dimensions[] |
המאפיינים המבוקשים ומוצגים. |
metrics[] |
המדדים המבוקשים ומוצגים. |
dateRanges[] |
טווחי תאריכים של נתונים לקריאה. אם תשלחו בקשה לכמה טווחי תאריכים, כל שורת תגובה תכיל אינדקס של טווח תאריכים שמבוסס על אפס. אם שני טווחי תאריכים חופפים, נתוני האירועים של הימים החופפים נכללים בשורות התגובה של שני טווחי התאריכים. בבקשת קבוצה בעלת מאפיינים משותפים, צריך לא לציין את ה |
dimensionFilter |
מסנני מאפיינים מאפשרים לבקש רק ערכי מאפיינים ספציפיים בדוח. לקבלת דוגמאות, ניתן לעיין במאמר היסודות של מסנני מאפיינים. אי אפשר להשתמש במדדים במסנן הזה. |
metricFilter |
סעיף הסינון של המדדים. מיושם אחרי צבירת השורות בדוח, בדומה לסעיף SQL. אי אפשר להשתמש במאפיינים במסנן הזה. |
offset |
מספר השורות בשורת ההתחלה. השורה הראשונה נספרת כשורה 0. במהלך החלוקה לדפים, הבקשה הראשונה לא מציינת קיזוז. או באופן שווה, מגדיר את הקיזוז ל-0; הבקשה הראשונה מחזירה את מידע נוסף על פרמטר העימוד הזה זמין במאמר עימוד. |
limit |
מספר השורות שיש להחזיר. אם לא מציינים שום אפשרות, יוחזרו 10,000 שורות. ה-API מחזיר עד 250,000 שורות לכל בקשה, לא משנה כמה מבקשים. הערך ה-API יכול גם להחזיר פחות שורות מהשדה מידע נוסף על פרמטר העימוד הזה זמין במאמר עימוד. |
metricAggregations[] |
צבירת מדדים. ערכי המדדים המצטברים יוצגו בשורות שבהן המאפיין assetValues מוגדר כ-"RESERVED_(MetricAggregation)". |
orderBys[] |
מציינת את סדר השורות בתגובה. |
currencyCode |
קוד מטבע בפורמט ISO4217, למשל 'AED', 'USD', 'JPY'. אם השדה ריק, הדוח יתבסס על מטבע ברירת המחדל של הנכס. |
cohortSpec |
קבוצה בעלת מאפיינים משותפים שמשויכת לבקשה הזו. אם הבקשה מכילה קבוצה בעלת מאפיינים משותפים, הבקשה כוללת את ה'קבוצה בעלת מאפיינים משותפים' חייב להיות קיים. |
keepEmptyRows |
אם הערך הוא False או לא צוין, לא תוחזר כל שורה שבה כל המדדים שווים ל-0. אם הערך הוא True, השורות האלה יוחזרו אם המסנן לא מסיר אותן בנפרד. בלי קשר להגדרת לדוגמה, אם נכס אף פעם לא מתועד אירוע |
returnPropertyQuota |
החלפת מצב אם להחזיר את המצב הנוכחי של המכסה של נכס Analytics הזה. המכסה מוחזרת ב-PropertyQuota. |
comparisons[] |
זה שינוי אופציונלי. הגדרות ההשוואות המבוקשות והמוצגות. כדי לקבל בתשובה עמודת השוואה, הבקשה צריכה לכלול רק שדה השוואות. |