Method: accounts.locations.reportInsights

返回一个报告，其中包含按地理位置对一项或多项指标的数据分析。

HTTP 请求

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:reportInsights

网址采用 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 代码。如果未提供语言代码，则默认为英语。

NumDays

此请求支持的天数。

枚举
SEVEN 7 天。这是默认值。
THIRTY 30 天。
NINETY 90 天。

LocationMetrics

与某个营业地点在某个时间范围内相关联的一系列指标和细分指标。

JSON 表示法 
{
  "locationName": string,
  "timeZone": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
字段
locationName

string

这些值所属的位置资源名称。
timeZone

string

相应位置的 IANA 时区。
metricValues[]

object (MetricValue)

所请求指标的值列表。

LocationDrivingDirectionMetrics

按用户通常来自的地区编入索引的位置。可通过计算从每个区域到此位置的行车路线请求数量来捕获数据。

JSON 表示法 
{
  "locationName": string,
  "topDirectionSources": [
    {
      object (TopDirectionSources)
    }
  ],
  "timeZone": string
}
字段
locationName

string

此指标值所属的位置资源名称。
topDirectionSources[]

object (TopDirectionSources)

行车路线请求（按来源区域）。按照惯例，这些结果按计数排序，最多显示 10 个结果。
timeZone

string

相应位置的时区（IANA 时区 ID，例如“Europe/London”）。

TopDirectionSources

发起导航请求的主要区域。

JSON 表示法 
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
字段
dayCount

integer

数据的汇总天数。
regionCounts[]

object (RegionCount)

按数量降序排序的区域。

RegionCount

某个区域及其关联的请求数。

JSON 表示法 
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
字段
latlng

object (LatLng)

区域中心。
label

string

地区的直观易懂的标签。
count

string (int64 format)

来自此区域的行车路线请求数。