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)

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