- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi cấp phép
- BusinessCallsInsights
- MetricType
- AggregateMetrics
- HourlyMetrics
- WeekDayMetrics
- DayOfWeek
- Ngày
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 |
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 |
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 |
Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi Khi phân trang, tất cả các thông số khác được cung cấp cho |
filter |
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 ( |
Các trường | |
---|---|
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 |
Mã thông báo có thể được gửi dưới dạ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 ( |
Các trường | |
---|---|
name |
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 |
Chỉ số mà giá trị áp dụng. |
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 ( |
Các trường | |
---|---|
missedCallsCount |
Tổng số cuộc gọi nhỡ. |
answeredCallsCount |
Tổng số cuộc gọi đã trả lời. |
hourlyMetrics[] |
Danh sách số liệu theo giờ trong ngày. |
weekdayMetrics[] |
Danh sách chỉ số theo ngày trong tuần. |
startDate |
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 |
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 |
Giờ trong ngày. Chỉ cho phép các giá trị trong khoảng 0-23. |
missedCallsCount |
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 ( |
Các trường | |
---|---|
day |
Ngày trong tuần. Giá trị được phép là Chủ Nhật – Thứ Bảy. |
missedCallsCount |
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 |
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 |
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 |
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. |