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 для языка. Если код языка не указан, по умолчанию используется английский.

Число дней

Количество дней, в течение которых этот запрос может поддерживаться.

Перечисления
SEVEN 7 дней. Это значение по умолчанию.
THIRTY 30 дней.
NINETY 90 дней.

МестоположениеМетрики

Ряд показателей и показателей BreakdownMetrics, связанных с местоположением за определенный период времени.

JSON-представление
{
  "locationName": string,
  "timeZone": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Поля
locationName

string

Имя ресурса местоположения, которому принадлежат эти значения.

timeZone

string

Часовой пояс IANA для данного местоположения.

metricValues[]

object ( MetricValue )

Список значений запрошенных метрик.

МестоположениеВождениеНаправлениеМетрики

Местоположение, индексированное по регионам, из которых обычно приезжают люди. Это фиксируется путем подсчета количества запросов направления движения к этому местоположению из каждого региона.

JSON-представление
{
  "locationName": string,
  "topDirectionSources": [
    {
      object (TopDirectionSources)
    }
  ],
  "timeZone": string
}
Поля
locationName

string

Имя ресурса местоположения, которому принадлежит это значение метрики.

topDirectionSources[]

object ( TopDirectionSources )

Запросы направления движения по исходному региону. По соглашению они сортируются по количеству и дают не более 10 результатов.

timeZone

string

Часовой пояс (идентификаторы часовых поясов IANA, например, «Европа/Лондон») местоположения.

ТопНаправлениеИсточники

Основные регионы, из которых поступали запросы о направлении движения.

JSON-представление
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
Поля
dayCount

integer

Данные о количестве дней агрегируются.

regionCounts[]

object ( RegionCount )

Регионы отсортированы в порядке убывания количества.

РегионКаунт

Регион со связанным с ним количеством запросов.

JSON-представление
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
Поля
latlng

object ( LatLng )

Центр региона.

label

string

Читаемая человеком метка региона.

count

string ( int64 format)

Количество запросов направления движения из этого региона.