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

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

• الإحصاءات المتوافقة
• الإحصاءات الأساسية
• اتجاهات القيادة

قبل البدء

قبل استخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google"، عليك تسجيل تطبيقك. والحصول على بيانات اعتماد 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"
      }
}