Method: accounts.locations.reportInsights

تعرض تقريرًا يحتوي على إحصاءات عن مقياس واحد أو أكثر حسب الموقع الجغرافي.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز 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

عدد الأيام التي يمكن خلالها إتاحة هذا الطلب.

عمليات التعداد
SEVEN 7 أيام. هذه هي القيمة الافتراضية.
THIRTY 30 يومًا.
NINETY 90 يومًا.

LocationMetrics

يشير ذلك المصطلح إلى سلسلة من المقاييس ومقاييس التفاصيل المرتبطة بموقع جغرافي معيّن على مدار نطاق زمني معيّن.

تمثيل 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، مثل "أوروبا/لندن") للموقع الجغرافي.

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)

عدد طلبات اتجاهات القيادة من هذه المنطقة.