Method: accounts.locations.reportInsights

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

בקשת HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:reportInsights

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

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

פרמטרים
name

string

השם של משאב החשבון.

גוף הבקשה

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

ייצוג ב-JSON 
{
  "locationNames": [
    string
  ],
  "basicRequest": {
    object (BasicMetricsRequest)
  },
  "drivingDirectionsRequest": {
    object (DrivingDirectionMetricsRequest)
  }
}
שדות
locationNames[]

string

אוסף של מיקומים שרוצים לאחזר עבורם תובנות, שמצוינים לפי השמות שלהם.
basicRequest

object (BasicMetricsRequest)

בקשה לכלול בדוח תובנות בסיסיות לגבי מדדים.
drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

בקשה לכלול בדוח תובנות לגבי בקשות לקבלת מסלול נסיעה.

גוף התשובה

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

הודעת התשובה עבור Insights.ReportLocationInsights.

ייצוג ב-JSON 
{
  "locationMetrics": [
    {
      object (LocationMetrics)
    }
  ],
  "locationDrivingDirectionMetrics": [
    {
      object (LocationDrivingDirectionMetrics)
    }
  ]
}
שדות
locationMetrics[]

object (LocationMetrics)

אוסף של ערכי מדדים לפי מיקום.
locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

אוסף ערכים של מדדים שקשורים לכיוון הנסיעה.

היקפי הרשאות

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

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

למידע נוסף, ראו סקירה כללית על OAuth 2.0.

DrivingDirectionMetricsRequest

בקשה לקבלת תובנות לגבי מסלולי נסיעה.

ייצוג ב-JSON 
{
  "numDays": enum (NumDays),
  "languageCode": string
}
שדות
numDays

enum (NumDays)

מספר הימים לצבירה של הנתונים. התוצאות שיוחזרו יהיו נתונים זמינים מתוך מספר הימים האחרונים שביקשת. הערכים החוקיים הם 7, 30 ו-90.
languageCode

string

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

NumDays

מספר הימים שבהם הבקשה הזו יכולה לתמוך.

טיפוסים בני מנייה (enum)
SEVEN 7 ימים. זהו ערך ברירת המחדל.
THIRTY 30 ימים.
NINETY 90 ימים.

LocationMetrics

סדרה של מדדים ו-BreakdownMetrics שמשויכים למיקום מסוים בטווח זמן מסוים.

ייצוג ב-JSON 
{
  "locationName": string,
  "timeZone": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
שדות
locationName

string

השם של משאב המיקום שאליו שייכים הערכים.
timeZone

string

אזור הזמן של IANA למיקום.
metricValues[]

object (MetricValue)

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

LocationDrivingDirectionMetrics

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

ייצוג ב-JSON 
{
  "locationName": string,
  "topDirectionSources": [
    {
      object (TopDirectionSources)
    }
  ],
  "timeZone": string
}
שדות
locationName

string

השם של משאב המיקום שאליו שייך הערך של המדד.
topDirectionSources[]

object (TopDirectionSources)

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

string

אזור הזמן (מזהי אזורי זמן של IANA, לדוגמה, 'Europe/London') של המיקום.

TopDirectionSources

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

ייצוג ב-JSON 
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
שדות
dayCount

integer

מספר הימים שבהם הנתונים נצברים.
regionCounts[]

object (RegionCount)

אזורים שממוינים בסדר יורד לפי מספר.

RegionCount

אזור עם מספר הבקשות המשויך אליו.

ייצוג JSON 
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
שדות
latlng

object (LatLng)

מרכז האזור.
label

string

תווית של האזור שקריאה לאנשים.
count

string (int64 format)

מספר הבקשות לקבלת מסלול נסיעה מהאזור הזה.