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，例如「歐洲/倫敦」)。

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)

來自這個區域的行車路線要求數量。