- HTTP 要求
- 路徑參數
- 要求主體
- 回應主體
- 授權範圍
- DrivingDirectionMetricsRequest
- NumDays
- LocationMetrics
- LocationDrivingDirectionMetrics
- TopDirectionSources
- RegionCount
傳回報表,其中包含按地區劃分的一或多個指標的洞察。
HTTP 要求
POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:reportInsights
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
name |
帳戶資源名稱。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 | |
---|---|
{ "locationNames": [ string ], "basicRequest": { object ( |
欄位 | |
---|---|
locationNames[] |
要擷取洞察資料的地點集合,由名稱指定。 |
basicRequest |
要求在報表中納入基本指標洞察。 |
drivingDirectionsRequest |
要求將有關行車路線要求的深入分析資訊納入報告中。 |
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
Insights.ReportLocationInsights
的回應訊息。
JSON 表示法 | |
---|---|
{ "locationMetrics": [ { object ( |
欄位 | |
---|---|
locationMetrics[] |
按位置劃分的指標值集合。 |
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 |
匯總資料的天數。傳回的結果將包含過去要求的天數資料。有效值為 7、30 和 90。 |
languageCode |
語言的 BCP 47 代碼。如未提供語言代碼,則預設為英文。 |
NumDays
這項要求可以支援的天數。
列舉 | |
---|---|
SEVEN |
7 天。這是預設值。 |
THIRTY |
30 天。 |
NINETY |
90 天。 |
LocationMetrics
這是指在某個時間範圍內,與地點相關的一系列指標和 BreakdownMetrics。
JSON 表示法 | |
---|---|
{
"locationName": string,
"timeZone": string,
"metricValues": [
{
object ( |
欄位 | |
---|---|
locationName |
這些值所屬的位置資源名稱。 |
timeZone |
地點的 IANA 時區。 |
metricValues[] |
要求指標的值清單。 |
LocationDrivingDirectionMetrics
將使用者通常來自哪些地區編入索引。系統會計算各個區域前往這個地點的行車路線要求數量,藉此擷取這項資料。
JSON 表示法 | |
---|---|
{
"locationName": string,
"topDirectionSources": [
{
object ( |
欄位 | |
---|---|
locationName |
這個指標值所屬的位置資源名稱。 |
topDirectionSources[] |
按來源區域劃分的行車路線要求。按照慣例,這些結果是按數量排序,最多為 10 筆結果。 |
timeZone |
地點的時區 (IANA 時區 ID,例如「歐洲/倫敦」)。 |
TopDirectionSources
駕駛路線要求來源最高的區域。
JSON 表示法 | |
---|---|
{
"dayCount": integer,
"regionCounts": [
{
object ( |
欄位 | |
---|---|
dayCount |
資料匯總的天數。 |
regionCounts[] |
按數量遞減排序的區域。 |
RegionCount
與相關要求數量相關聯的區域。
JSON 表示法 | |
---|---|
{
"latlng": {
object ( |
欄位 | |
---|---|
latlng |
區域中心。 |
label |
使用者可理解的區域標籤。 |
count |
來自這個區域的駕駛路線要求數量。 |