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

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

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)

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