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

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

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

قبل البدء

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