Package google.mybusiness.businesscalls.v1

Chỉ mục

BusinessCallsService

API này cho phép các doanh nghiệp quản lý Cuộc gọi đến doanh nghiệp và thu thập thông tin chi tiết như số lượng cuộc gọi nhỡ đến vị trí của họ. Bạn có thể xem thêm thông tin về cuộc gọi cho doanh nghiệp tại https://support.google.com/business/answer/9688285?p=call_history

Nếu bạn bật Trang doanh nghiệp trên Google liên kết với một tài khoản Google Ads và nhật ký cuộc gọi, thì những cuộc gọi kéo dài hơn một thời gian cụ thể và có thể được phân bổ cho một lượt tương tác với quảng cáo, sẽ xuất hiện trong tài khoản Google Ads được liên kết trong mục lượt chuyển đổi "Cuộc gọi từ Google Ads". Nếu bạn sử dụng chiến lược đặt giá thầu thông minh và lượt chuyển đổi dẫn đến cuộc gọi trong chiến lược tối ưu hoá, thì mức chi tiêu quảng cáo có thể sẽ thay đổi. Tìm hiểu thêm về chiến lược Đặt giá thầu thông minh."

Để xem và thực hiện hành động đối với các cuộc gọi của một vị trí, bạn cần phải là OWNER, CO_OWNER hoặc MANAGER của vị trí đó.

GetBusinessCallsSettings

rpc GetBusinessCallsSettings(GetBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

Trả về tài nguyên cài đặt Cuộc gọi của doanh nghiệp cho vị trí cụ thể.

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.
ListBusinessCallsInsights

rpc ListBusinessCallsInsights(ListBusinessCallsInsightsRequest) returns (ListBusinessCallsInsightsResponse)

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.

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.
UpdateBusinessCallsSettings

rpc UpdateBusinessCallsSettings(UpdateBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

Cập nhật chế độ cài đặt Cuộc gọi doanh nghiệp cho vị trí đã chỉ định.

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.

AggregateMetrics

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

Các trường
missed_calls_count

Int32Value

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

Int32Value

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

HourlyMetrics

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

WeekDayMetrics

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

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.
end_date

Date

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

BusinessCallsInsights

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

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
metric_type

MetricType

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

AggregateMetrics

Chỉ số cho phạm vi thời gian dựa trên ngày_bắt_đầu và ngày_kết_thúc.

BusinessCallsSettings

Chế độ cài đặt cuộc gọi doanh nghiệp cho một địa điểm.

Các trường
name

string

Bắt buộc. Tên tài nguyên của các chế độ cài đặt cuộc gọi. Định dạng: locations/{location}/businessconversationsettings
calls_state

CallsState

Bắt buộc. Trạng thái đăng ký cuộc gọi đến doanh nghiệp của vị trí này.
consent_time

Timestamp

Chỉ nhập. Thời điểm khi người dùng cuối đồng ý cho phép người dùng API bật cuộc gọi doanh nghiệp.

CallsState

Các trạng thái có thể có của một vị trí trong cuộc gọi doanh nghiệp. Các trạng thái có thể được cập nhật thành chỉ BẬT hoặc TẮT. Mọi giá trị khác sẽ trả về lỗi PREcondition_FAILED.

Enum
CALLS_STATE_UNSPECIFIED Không xác định.
ENABLED Tính năng cuộc gọi doanh nghiệp được bật cho vị trí này.
DISABLED Cuộc gọi doanh nghiệp bị tắt cho vị trí này.

ErrorCode

Mã lỗi cho các lỗi nội bộ.

Enum
ERROR_CODE_UNSPECIFIED Mã lỗi không xác định.
ERROR_CODE_UNVERIFIED_LOCATION Vị trí chưa được xác minh.
ERROR_CODE_CALLS_NOT_ENABLED Trạng thái cuộc gọi của doanh nghiệp cho vị trí chưa được BẬT.
ERROR_CODE_NOT_ELIGIBLE_LOCATION Vị trí này không đủ điều kiện để gọi điện cho doanh nghiệp.

GetBusinessCallsSettingsRequest

Yêu cầu tin nhắn cho GetBusinessCallSettings.

Các trường
name

string

Bắt buộc. Cài đặt cuộc gọi doanh nghiệp để có.

Trường name dùng để xác định các chế độ cài đặt cuộc gọi doanh nghiệp cần nhận. Định dạng: locations/{location_id}/businessconversationsettings.

HourlyMetrics

Chỉ số trong một giờ.

Các trường
hour

Int32Value

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

Int32Value

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

ListBusinessCallsInsightsRequest

Yêu cầu tin nhắn đối với ListBusinesscallInsights.

Các trường
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/{location_id}
page_size

int32

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, page_size sẽ bị bỏ qua.
page_token

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi ListBusinessCallsInsights 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 ListBusinessCallsInsights 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 ngày kết thúc, thì ngày cuối cùng mà dữ liệu có sẵn sẽ được sử dụng. Nếu bạn không cung cấp ngày_bắt_đầu, chúng tôi sẽ đặt 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 ngày bắt đầu xuất hiện trước ngày có dữ liệu, thì dữ liệu sẽ được trả về kể từ ngày có dữ liệu.

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

ListBusinessCallsInsightsResponse

Tin nhắn phản hồi cho ListBusinessCallInsights.

Các trường
business_calls_insights[]

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.
next_page_token

string

Mã thông báo có thể được gửi dưới dạng page_token để 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 những chỉ số này, next_page_token sẽ để trống.

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.

UpdateBusinessCallsSettingsRequest

Yêu cầu tin nhắn đối với UpdateBusinessCallSettings.

Các trường
business_calls_settings

BusinessCallsSettings

Bắt buộc. Cài đặt cuộc gọi doanh nghiệp sẽ được cập nhật.

Trường name dùng để xác định các chế độ cài đặt cuộc gọi doanh nghiệp cần cập nhật. Định dạng: locations/{location_id}/businessconversationsettings
update_mask

FieldMask

Bắt buộc. Danh sách các trường cần cập nhật.

WeekDayMetrics

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

Các trường
day

DayOfWeek

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

Int32Value

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