اطلاعات بینش مکان را بازیابی کنید

این آموزش به شما نشان می‌دهد که چگونه معیارهای مکان را در نمایه کسب‌وکار بازیابی کنید. API گوگل مای بیزینس به شما امکان می‌دهد با معیارهای مکان کار کنید تا انواع داده‌های زیر را بازیابی کنید:

قبل از اینکه شروع کنی

قبل از استفاده از API گوگل مای بیزینس، باید برنامه خود را ثبت کنید و اعتبارنامه‌های OAuth 2.0 را دریافت کنید. برای جزئیات بیشتر در مورد نحوه شروع به کار با API گوگل مای بیزینس، به تنظیمات اولیه مراجعه کنید.

بینش‌های پشتیبانی‌شده

برای اطلاعات بیشتر در مورد داده‌های پشتیبانی‌شده، به صفحه مرجع Metric مراجعه کنید.

بینش‌های اساسی

اطلاعات پایه را برای لیست مشخصی از مکان‌ها بازیابی می‌کند. از API accounts.locations.reportInsights برای بازگرداندن اطلاعات مرتبط با یک مکان استفاده کنید.

برای بازگرداندن اطلاعات پایه مرتبط با یک مکان، از موارد زیر استفاده کنید:

اچ‌تی‌پی
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"
          }
    }
}

مسیرهای رانندگی

معیارهای مسیر رانندگی را برای لیست مشخصی از مکان‌ها بازیابی می‌کند. از API accounts.locations.reportInsights برای بازگرداندن معیارهای مسیر رانندگی مرتبط با یک مکان استفاده کنید.

برای برگرداندن معیارهای جهت رانندگی، از موارد زیر استفاده کنید:

اچ‌تی‌پی
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations:reportInsights
{
     "locationNames": [
             "accounts/{accountId}/locations/{locationId}"
       ],
      "drivingDirectionsRequest": {
          "numDays": "NINETY"
      }
}