Package google.mybusiness.businesscalls.v1

Indeks

BusinessCallsService

API ini memungkinkan bisnis untuk mengelola Panggilan Bisnis dan mengumpulkan insight, seperti jumlah panggilan tak terjawab ke lokasi bisnis. Informasi tambahan tentang Panggilan bisnis dapat ditemukan di https://support.google.com/business/answer/9688285?p=call_history

Jika Google Profil Bisnis ditautkan ke akun Google Ads dan histori panggilan diaktifkan, panggilan yang berlangsung lebih lama dari waktu tertentu dan yang dapat diatribusikan ke interaksi iklan, akan ditampilkan di akun Google Ads tertaut di bagian konversi "Panggilan Telepon dari Iklan". Jika smart bidding dan konversi panggilan digunakan dalam strategi pengoptimalan, mungkin ada perubahan dalam pembelanjaan iklan. Pelajari Smart Bidding lebih lanjut".

Untuk melihat dan melakukan tindakan pada panggilan lokasi, Anda harus menjadi OWNER, CO_OWNER, atau MANAGER lokasi tersebut.

GetBusinessCallsSettings

rpc GetBusinessCallsSettings(GetBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

Menampilkan resource setelan Panggilan bisnis untuk lokasi yang ditentukan.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ListBusinessCallsInsights

rpc ListBusinessCallsInsights(ListBusinessCallsInsightsRequest) returns (ListBusinessCallsInsightsResponse)

Menampilkan insight panggilan Bisnis untuk lokasi.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
UpdateBusinessCallsSettings

rpc UpdateBusinessCallsSettings(UpdateBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

Memperbarui setelan Panggilan bisnis untuk lokasi yang ditentukan.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

AggregateMetrics

Metrik yang digabungkan selama rentang waktu input.

Kolom
missed_calls_count

Int32Value

Jumlah total panggilan tak terjawab.
answered_calls_count

Int32Value

Jumlah total panggilan terjawab.
hourly_metrics[]

HourlyMetrics

Daftar metrik berdasarkan jam.
weekday_metrics[]

WeekDayMetrics

Daftar metrik berdasarkan hari.
start_date

Date

Tanggal untuk metrik ini. Jika metrik adalah bulanan, hanya tahun dan bulan yang digunakan.
end_date

Date

Tanggal akhir untuk metrik ini.

BusinessCallsInsights

Analisis untuk panggilan yang dilakukan ke lokasi.

Kolom
name

string

Wajib. Nama resource insight panggilan. Format: locations/{location}/businesscallsinsights
metric_type

MetricType

Metrik yang nilainya diterapkan.
aggregate_metrics

AggregateMetrics

Metrik untuk rentang waktu berdasarkan start_date dan end_date.

BusinessCallsSettings

Setelan panggilan bisnis untuk lokasi.

Kolom
name

string

Wajib. Nama resource setelan panggilan. Format: locations/{location}/businesscallssettings
calls_state

CallsState

Wajib. Status pendaftaran lokasi ini dalam panggilan Bisnis.
consent_time

Timestamp

Hanya input. Waktu saat pengguna akhir memberikan izin kepada pengguna API untuk mengaktifkan panggilan bisnis.

CallsState

Kemungkinan status lokasi dalam panggilan bisnis. Status dapat diperbarui hanya menjadi DIAKTIFKAN atau DINONAKTIFKAN. Apa pun yang lain akan menampilkan kesalahan PRECONDITION_FAILED.

Enum
CALLS_STATE_UNSPECIFIED Tidak ditentukan.
ENABLED Panggilan bisnis diaktifkan untuk lokasi.
DISABLED Panggilan bisnis dinonaktifkan untuk lokasi ini.

ErrorCode

Kode error untuk kegagalan internal.

Enum
ERROR_CODE_UNSPECIFIED Kode error belum ditetapkan.
ERROR_CODE_UNVERIFIED_LOCATION Lokasi tidak diverifikasi.
ERROR_CODE_CALLS_NOT_ENABLED Status panggilan Bisnis untuk lokasi tidak DIAKTIFKAN.
ERROR_CODE_NOT_ELIGIBLE_LOCATION Lokasi tidak memenuhi syarat untuk panggilan bisnis.

GetBusinessCallsSettingsRequest

Pesan permintaan untuk GetBusinessCallsSettings.

Kolom
name

string

Wajib. BusinessCallsSettings untuk mendapatkannya.

Kolom name digunakan untuk mengidentifikasi setelan panggilan bisnis yang harus didapatkan. Format: locations/{location_id}/businesscallssettings.

HourlyMetrics

Metrik selama satu jam.

Kolom
hour

Int32Value

Jam. Nilai yang diizinkan adalah 0-23.
missed_calls_count

Int32Value

Jumlah total panggilan tak terjawab untuk jam ini.

ListBusinessCallsInsightsRequest

Pesan permintaan untuk ListBusinessCallsInsights.

Kolom
parent

string

Wajib. Lokasi induk untuk mengambil insight panggilan. Format: locations/{location_id}
page_size

int32

Opsional. Jumlah maksimum BusinessCallsInsights yang akan ditampilkan. Jika tidak ditentukan, maksimal 20 akan ditampilkan. Beberapa metric_types(mis, AGGREGATE_COUNT) menampilkan satu halaman. Untuk metrik ini, page_size diabaikan.
page_token

string

Opsional. Token halaman, diterima dari panggilan ListBusinessCallsInsights sebelumnya. Berikan ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk ListBusinessCallsInsights harus cocok dengan panggilan yang menyediakan token halaman. Beberapa metric_types (mis, AGGREGATE_COUNT) menampilkan satu halaman. Untuk metrik ini, pake_token akan diabaikan.
filter

string

Opsional. Filter yang membatasi insight panggilan yang akan ditampilkan. Responsnya hanya menyertakan entri yang cocok dengan filter.

Jika MetricType tidak diberikan, AGGREGATE_COUNT akan ditampilkan. Jika tidak ada end_date yang diberikan, tanggal terakhir data yang tersedia akan digunakan. Jika tidak ada start_date yang diberikan, kami akan menetapkan secara default ke tanggal pertama saat data tersedia, yaitu 6 bulan. Jika start_date jatuh sebelum tanggal saat data tersedia, data akan ditampilkan mulai dari tanggal saat data tersedia.

Saat ini kami mendukung filter berikut. 1. start_date="DATE" dengan tanggal dalam format YYYY-MM-DD. 2. end_date="DATE" dengan tanggal dalam format YYYY-MM-DD. 3. metric_type=XYZ dengan XYZ adalah MetricType yang valid. 4. Konjungsi(AND) dari semua hal di atas, misalnya, "start_date=01-08-2021 AND end_date=10-08-2021 AND metric_type=AGGREGATE_COUNT" AGGREGATE_COUNT metric_type mengabaikan bagian DD pada tanggal tersebut.

ListBusinessCallsInsightsResponse

Pesan respons untuk ListBusinessCallsInsights.

Kolom
business_calls_insights[]

BusinessCallsInsights

Kumpulan insight panggilan bisnis untuk lokasi.
next_page_token

string

Token, yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak ada halaman berikutnya. Beberapa metric_types (mis, AGGREGATE_COUNT) menampilkan satu halaman. Untuk metrik ini, next_page_token akan kosong.

MetricType

Jenis metrik.

Enum
METRIC_TYPE_UNSPECIFIED Jenis metrik tidak ditentukan.
AGGREGATE_COUNT Metrik yang disediakan adalah jumlah yang digabungkan selama input_range_range.

UpdateBusinessCallsSettingsRequest

Pesan permintaan untuk UpdateBusinessCallsSettings.

Kolom
business_calls_settings

BusinessCallsSettings

Wajib. BusinessCallsSettings yang akan diperbarui.

Kolom name digunakan untuk mengidentifikasi setelan panggilan bisnis yang akan diperbarui. Format: locations/{location_id}/businesscallssettings
update_mask

FieldMask

Wajib. Daftar kolom yang akan diperbarui.

WeekDayMetrics

Metrik untuk hari kerja.

Kolom
day

DayOfWeek

Hari. Nilai yang diizinkan adalah Minggu - Sabtu.
missed_calls_count

Int32Value

Jumlah total panggilan tak terjawab untuk jam ini.