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)

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