Method: locations.businesscallsinsights.list

Trả về thông tin chi tiết cho các cuộc gọi của doanh nghiệp cho một địa điểm.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
parent

string

Bắt buộc. Vị trí mẹ để tìm nạp thông tin chi tiết về cuộc gọi. Định dạng: locations/{locationId}

Tham số truy vấn

Các tham số
pageSize

integer

Không bắt buộc. Số lượng BusinessCallInsights tối đa cần trả về. Nếu không chỉ định, hệ thống sẽ trả về tối đa 20 kết quả. Một số kiểu_chỉ_số(ví dụ: AGGREGATE_COUNT) trả về một trang duy nhất. Đối với các chỉ số này, pageSize sẽ bị bỏ qua.
pageToken

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi businesscallsinsights.list trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các thông số khác được cung cấp cho businesscallsinsights.list phải khớp với lệnh gọi đã cung cấp mã thông báo trang. Một số metric_type (ví dụ: AGGREGATE_COUNT) trả về một trang duy nhất. Đối với các chỉ số này, pake_token sẽ bị bỏ qua.
filter

string

Không bắt buộc. Bộ lọc hạn chế việc trả về thông tin chi tiết về cuộc gọi. Phản hồi chỉ bao gồm các mục khớp với bộ lọc.

Nếu không cung cấp MetricsType, thì AGGREGATE_COUNT sẽ được trả về. Nếu bạn không cung cấp endDate, thì ngày cuối cùng mà dữ liệu có sẵn sẽ được sử dụng. Nếu không cung cấp startDate, chúng tôi sẽ mặc định là ngày đầu tiên có dữ liệu, hiện tại là ngày 6 tháng. Nếu startDate trước ngày có dữ liệu, thì dữ liệu sẽ được trả về kể từ ngày có sẵn.

Tại thời điểm này, chúng tôi hỗ trợ các bộ lọc sau. 1. startDate="DATE" trong đó ngày ở định dạng YYYY-MM-DD. 2. endDate="DATE" trong đó ngày ở định dạng YYYY-MM-DD. 3. metricType=XYZ trong đó XYZ là mộtMetricType hợp lệ. 4. Liên từ(AND) của tất cả các trường hợp trên. Ví dụ: "startDate=2021-08-01 AND endDate=2021-08-10 AND metricType=AGGREGATE_COUNT" AGGREGATE_COUNT metricType bỏ qua phần DD của ngày.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Thông báo phản hồi cho businessinsightsinsights.list.

Biểu diễn dưới dạng JSON 
{
  "businessCallsInsights": [
    {
      object (BusinessCallsInsights)
    }
  ],
  "nextPageToken": string
}
Các trường
businessCallsInsights[]

object (BusinessCallsInsights)

Một tập hợp thông tin chi tiết về cuộc gọi của doanh nghiệp cho địa điểm.
nextPageToken

string

Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua thì không có trang tiếp theo nào. Một số metric_type (ví dụ: AGGREGATE_COUNT) trả về một trang duy nhất. Đối với các chỉ số này, nextPageToken sẽ bị trống.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

BusinessCallsInsights

Thông tin chi tiết về cuộc gọi đến một địa điểm.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "metricType": enum (MetricType),
  "aggregateMetrics": {
    object (AggregateMetrics)
  }
}
Các trường
name

string

Bắt buộc. Tên tài nguyên của thông tin chi tiết về cuộc gọi. Định dạng: location/{location}/businessinsightsinsights
metricType

enum (MetricType)

Chỉ số mà giá trị áp dụng.
aggregateMetrics

object (AggregateMetrics)

Chỉ số cho phạm vi thời gian dựa trên startDate và endDate.

MetricType

Loại chỉ số.

Enum
METRIC_TYPE_UNSPECIFIED Chưa xác định loại chỉ số.
AGGREGATE_COUNT Chỉ số được cung cấp là số lượng tổng hợp trên phạm vi thời gian đầu vào.

AggregateMetrics

Các chỉ số được tổng hợp trong phạm vi thời gian nhập.

Biểu diễn dưới dạng JSON 
{
  "missedCallsCount": integer,
  "answeredCallsCount": integer,
  "hourlyMetrics": [
    {
      object (HourlyMetrics)
    }
  ],
  "weekdayMetrics": [
    {
      object (WeekDayMetrics)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Các trường
missedCallsCount

integer

Tổng số cuộc gọi nhỡ.
answeredCallsCount

integer

Tổng số cuộc gọi đã trả lời.
hourlyMetrics[]

object (HourlyMetrics)

Danh sách số liệu theo giờ trong ngày.
weekdayMetrics[]

object (WeekDayMetrics)

Danh sách chỉ số theo ngày trong tuần.
startDate

object (Date)

Ngày áp dụng cho chỉ số này. Nếu chỉ số là hằng tháng, thì hệ thống sẽ chỉ sử dụng năm và tháng.
endDate

object (Date)

Ngày kết thúc cho chỉ số này.

HourlyMetrics

Chỉ số trong một giờ.

Biểu diễn dưới dạng JSON 
{
  "hour": integer,
  "missedCallsCount": integer
}
Các trường
hour

integer

Giờ trong ngày. Chỉ cho phép các giá trị trong khoảng 0-23.
missedCallsCount

integer

Tổng số cuộc gọi nhỡ trong giờ này.

WeekDayMetrics

Chỉ số cho một ngày trong tuần.

Biểu diễn dưới dạng JSON 
{
  "day": enum (DayOfWeek),
  "missedCallsCount": integer
}
Các trường
day

enum (DayOfWeek)

Ngày trong tuần. Giá trị được phép là Chủ Nhật – Thứ Bảy.
missedCallsCount

integer

Tổng số cuộc gọi nhỡ trong giờ này.

DayOfWeek

Đại diện cho một ngày trong tuần.

Enum
DAY_OF_WEEK_UNSPECIFIED Chưa xác định ngày trong tuần.
MONDAY Thứ Hai
TUESDAY Thứ Ba
WEDNESDAY Thứ Tư
THURSDAY Thursday (thứ Năm)
FRIDAY Thứ Sáu
SATURDAY Saturday (thứ Bảy)
SUNDAY Chủ Nhật

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không đáng kể. Ngày này có liên quan đến Dương lịch. Điều này có thể đại diện cho một trong những điều sau:

  • Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0
  • Tháng và ngày, có năm bằng 0 (ví dụ: ngày kỷ niệm)
  • Chỉ có một năm với một tháng không có ngày nào
  • Năm và tháng, không có ngày (ví dụ: ngày hết hạn thẻ tín dụng)

Các loại có liên quan: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Các trường
year

integer

Năm của ngày tháng. Phải từ 1 đến 9999 hoặc 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Phải từ 1 đến 12 hoặc từ 0 để chỉ định một năm không có tháng và ngày.
day

integer

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc 0 để chỉ định một năm hoặc một năm và tháng không có ngày quan trọng.