Method: projects.locations.brands.computeAnalyticsMetrics

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

בקשת HTTP

GET https://foodorderingaiagent.googleapis.com/v1beta/{brand=projects/*/locations/*/brands/*}:computeAnalyticsMetrics

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
brand

string

חובה. המותג שעבורו רוצים לקבל מדדי ניתוח נתונים. פורמט: projects/{project}/locations/{location}/brands/{brand}

פרמטרים של שאילתה

פרמטרים
timestamps[]

string (Timestamp format)

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

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
storeIds[]

string

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

enum (AnalyticsType)

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

object (FeatureGate)

זה שינוי אופציונלי. שערי תכונות.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

הודעת התשובה של MenuService.ComputeAnalyticsMetrics.

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

ייצוג ב-JSON 
{
  "analyticsMetrics": {
    object (AnalyticsMetrics)
  }
}
שדות
analyticsMetrics

object (AnalyticsMetrics)

פלט בלבד. מדדי הניתוח של המותג.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/cloud-platform

ניתן למצוא מידע נוסף כאן: Authentication Overview.

AnalyticsType

סוג הניתוח שרוצים לחשב.

טיפוסים בני מנייה (enum)
ANALYTICS_TYPE_UNSPECIFIED סוג ניתוח לא מזוהה.
GENERIC לחשב מדדים כלליים (למשל, מספר ההזמנות, מספר ההעברות לטיפול ברמה גבוהה יותר, מספר המכירות של מוצר או שירות משודרג).
DAILY לחשב מדדים יומיים (למשל, מספר ההזמנות וההעברות לטיפול ברמה גבוהה יותר).
PREDICTED_FAILURE_CATEGORIES חישוב מדדים של קטגוריית כשל חזויה (למשל, ספירת קטגוריית כשל חזויה).

FeatureGate

‫Feature Gates לשליטה בהתנהגות של חישוב ניתוח הנתונים.

ייצוג ב-JSON 
{
  "enableAggregationData": boolean
}
שדות
enableAggregationData

boolean

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

AnalyticsMetrics

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

ייצוג ב-JSON 
{
  "intervalMetrics": [
    {
      object (IntervalMetrics)
    }
  ]
}
שדות
intervalMetrics[]

object (IntervalMetrics)

מדדים למרווחי הזמן.

IntervalMetrics

מייצג מדדי ניתוח נתונים לפרק זמן ספציפי.

ייצוג ב-JSON 
{
  "interval": {
    object (Interval)
  },
  "totalOrderCount": string,
  "successOrderCount": string,
  "avgOrderDurationMs": string,
  "upsellSuccessRate": number,
  "upsellRevenue": {
    object (Money)
  },
  "escalationCount": string,
  "predictedFailureCategoryCounts": [
    {
      object (PredictedFailureCategoryCount)
    }
  ],
  "invalidOrderCount": string,
  "crewEscalationCount": string
}
שדות
interval

object (Interval)

שעת ההתחלה או הסיום שמשתקפת במדדים האלה.
totalOrderCount

string (int64 format)

פלט בלבד. המספר הכולל של ההזמנות.
successOrderCount

string (int64 format)

פלט בלבד. מספר ההזמנות שהושלמו.
avgOrderDurationMs

string (int64 format)

פלט בלבד. משך הזמן הממוצע של ההזמנה באלפיות השנייה.
upsellSuccessRate

number

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

object (Money)

פלט בלבד. ההכנסה ממכירת מוצר או שירות משודרג (upsell).
escalationCount

string (int64 format)

פלט בלבד. מספר הקבוצות של תוצאות ההעברה לטיפול ברמה גבוהה יותר.
predictedFailureCategoryCounts[]

object (PredictedFailureCategoryCount)

פלט בלבד. מספר התקלות הצפויות לפי קטגוריה.
invalidOrderCount

string (int64 format)

פלט בלבד. המספר הכולל של הזמנות לא חוקיות.
crewEscalationCount

string (int64 format)

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

PredictedFailureCategoryCount

מספר קטגוריות הכשלים הצפויות.

ייצוג ב-JSON 
{
  "category": string,
  "count": string
}
שדות
category

string

פלט בלבד. קטגוריית הכשל החזויה.
count

string (int64 format)

פלט בלבד. מספר הסשנים בקטגוריה הזו.