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

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)

來自這個區域的駕駛路線要求數量。