استرداد إحصاءات الموقع الجغرافي

توضّح لك هذه المقالة التعليمية كيفية استرداد مقاييس الموقع الجغرافي في "الملف التجاري على Google". تمنحك واجهة برمجة التطبيقات "نشاطي التجاري على Google" إمكانية العمل مع مقاييس المواقع الجغرافية لاسترداد الأنواع التالية من البيانات:

قبل البدء

قبل استخدام Google My Business API، عليك تسجيل تطبيقك والحصول على بيانات اعتماد OAuth 2.0. لمعرفة تفاصيل عن كيفية بدء استخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google"، اطّلِع على الإعداد الأساسي.

الإحصاءات المتاحة

للاطّلاع على الإحصاءات المتوافقة، يُرجى الاطّلاع على صفحة مرجع المقياس.

الإحصاءات الأساسية

يسترجع الإحصاءات الأساسية لقائمة معيّنة من المواقع الجغرافية. استخدِم واجهة برمجة التطبيقات accounts.locations.reportInsights لعرض الإحصاءات المرتبطة بموقع جغرافي.

لعرض الإحصاءات الأساسية المرتبطة بموقع جغرافي، استخدِم ما يلي:

بروتوكول HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations:reportInsights
{
  "locationNames": [
    "accounts/{accountId}/locations/{locationId}"
  ],
  "basicRequest": {
          "metricRequests": [
             {
               "metric": "QUERIES_DIRECT"
             },
             {
               "metric": "QUERIES_INDIRECT"
             }
          ],
          "timeRange": {
               "startTime": "2016-10-12T01:01:23.045123456Z",
               "endTime": "2017-01-10T23:59:59.045123456Z"
          }
    }
}

اتجاهات القيادة

يسترجع مقاييس اتّجاهات القيادة لقائمة معيّنة من المواقع الجغرافية. استخدِم واجهة برمجة التطبيقات accounts.locations.reportInsights لعرض مقاييس اتجاهات القيادة المرتبطة بموقع جغرافي.

لعرض مقاييس اتجاه القيادة، استخدِم ما يلي:

بروتوكول HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations:reportInsights
{
     "locationNames": [
             "accounts/{accountId}/locations/{locationId}"
       ],
      "drivingDirectionsRequest": {
          "numDays": "NINETY"
      }
}