Method: locations.businesscallsinsights.list

傳回特定地點的商家來電洞察資料。

HTTP 要求

GET https://mybusinessbusinesscalls.googleapis.com/v1/{parent=locations/*}/businesscallsinsights

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。要擷取來電洞察資料的上層位置。格式：locations/{locationId}

查詢參數

參數
pageSize

integer

選用設定。要傳回的 BusinessCallsInsight 數量上限。如未指定，最多會傳回 20 個。部分 metric_types(例如 AGGREGATE_COUNT) 會傳回單一網頁。針對這些指標，系統會忽略 pageSize。
pageToken

string

選用設定。屬於接收自前一個 businesscallsinsights.list 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 businesscallsinsights.list 的所有其他參數須與提供網頁權杖的呼叫相符。某些 metric_types (例如 AGGREGATE_COUNT) 會傳回單一網頁。針對這些指標，系統會忽略 pake_token。
filter

string

選用設定。篩選器會限制要傳回的來電洞察資料。回應只會包含與篩選條件相符的項目。

如未提供 MetricType，則會傳回 AGGREGATE_COUNT。如果沒有提供 endDate，則會使用最新可用資料的日期。如果沒有提供 startDate，系統會預設為可用資料的日期，目前為 6 個月。如果 startDate 早於可取得資料的日期，則系統會從系統可提供資料當天開始傳回資料。

目前我們支援下列篩選器。1. startDate="DATE"日期格式為 YYYY-MM-DD。2. endDate="DATE"日期格式為 YYYY-MM-DD。3. metricType=XYZ，其中 XYZ 是有效的 MetricType。4. 上述所有連接法(AND)。例如："startDate=2021-08-01 AND endDate=2021-08-10 AND metricType=AGGREGATE_COUNT"AGGREGATE_COUNT metricType 會忽略日期中的 DD 部分。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體會含有以下結構的資料：

businesscallsinsights.list 回應訊息。

JSON 表示法 
{
  "businessCallsInsights": [
    {
      object (BusinessCallsInsights)
    }
  ],
  "nextPageToken": string
}
欄位
businessCallsInsights[]

object (BusinessCallsInsights)

一組商家來電洞察資料。
nextPageToken

string

可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續網頁。某些 metric_types (例如 AGGREGATE_COUNT) 會傳回單一網頁。這些指標的 nextPageToken 將留空。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/business.manage

詳情請參閱 OAuth 2.0 總覽。

BusinessCallsInsights

地點來電的深入分析。

JSON 表示法 
{
  "name": string,
  "metricType": enum (MetricType),
  "aggregateMetrics": {
    object (AggregateMetrics)
  }
}
欄位
name

string

必要欄位。呼叫深入分析的資源名稱。格式：locations/{location}/businesscallsinsights
metricType

enum (MetricType)

值適用的指標。
aggregateMetrics

object (AggregateMetrics)

以 startDate 和 endDate 為依據的時間範圍指標。

MetricType

指標類型。

列舉
METRIC_TYPE_UNSPECIFIED 未指定指標類型。
AGGREGATE_COUNT 提供的指標是輸入時間範圍的匯總計數。

AggregateMetrics

輸入時間範圍內匯總的指標。

JSON 表示法 
{
  "missedCallsCount": integer,
  "answeredCallsCount": integer,
  "hourlyMetrics": [
    {
      object (HourlyMetrics)
    }
  ],
  "weekdayMetrics": [
    {
      object (WeekDayMetrics)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
欄位
missedCallsCount

integer

未接來電總數。
answeredCallsCount

integer

已接來電總數。
hourlyMetrics[]

object (HourlyMetrics)

依時段列出的指標清單。
weekdayMetrics[]

object (WeekDayMetrics)

依星期幾區分的指標清單。
startDate

object (Date)

這項指標的日期。如果指標是按月計算，則只能使用年和月份。
endDate

object (Date)

這項指標的結束日期。

HourlyMetrics

一小時的指標。

JSON 表示法 
{
  "hour": integer,
  "missedCallsCount": integer
}
欄位
hour

integer

時段。有效值為 0 至 23。
missedCallsCount

integer

此小時未接來電總數。

WeekDayMetrics

一週的指標。

JSON 表示法 
{
  "day": enum (DayOfWeek),
  "missedCallsCount": integer
}
欄位
day

enum (DayOfWeek)

星期幾。允許的值為週日至週六。
missedCallsCount

integer

此小時未接來電總數。

DayOfWeek

代表星期幾。

列舉
DAY_OF_WEEK_UNSPECIFIED 未指定星期幾。
MONDAY 星期一
TUESDAY 週二
WEDNESDAY 週三
THURSDAY 週四
FRIDAY Friday (週五)
SATURDAY Saturday (週六)
SUNDAY 星期日

日期

代表完整或部分的日曆日期，例如生日。您可以指明時段和時區，或者在其他地方指定時間或時區。日期以公曆為基準。可能代表下列其中一項：

  • 完整日期，具有非零的年、月和日值
  • 日期為 0 的月份和日期 (例如週年紀念日)
  • 有 1 年，第 0 個月卻為 0 天
  • 年份和月份，數字為零 (例如信用卡到期日)

相關類型：* google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
欄位
year

integer

日期的年份。這個值必須介於 1 至 9999，或 0 之間可指定不含年份的日期。
month

integer

一年中的月份。必須介於 1 到 12 之間，或 0 可以指定不含月份和日期的年份。
day

integer

一個月中的第幾天。這個值必須介於 1 至 31 之間，且有效的年份和月份；或 0 可讓您指定本身或年份和月份，但這些日期不明顯。