Method: locations.businesscallsinsights.list

Menampilkan insight panggilan Bisnis untuk lokasi.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

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

Parameter kueri

Parameter
pageSize

integer

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, pageSize akan diabaikan.

pageToken

string

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

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk businesscallsinsights.list 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 endDate yang diberikan, tanggal terakhir data yang tersedia akan digunakan. Jika startDate tidak diberikan, secara default kami akan menggunakan tanggal pertama saat data tersedia, yaitu 6 bulan. Jika startDate adalah sebelum tanggal saat data tersedia, data akan ditampilkan mulai dari tanggal saat data tersedia.

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

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan respons untuk businesscallsinsights.list.

Representasi JSON
{
  "businessCallsInsights": [
    {
      object (BusinessCallsInsights)
    }
  ],
  "nextPageToken": string
}
Kolom
businessCallsInsights[]

object (BusinessCallsInsights)

Kumpulan insight panggilan bisnis untuk lokasi.

nextPageToken

string

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

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

BusinessCallsInsights

Analisis untuk panggilan yang dilakukan ke lokasi.

Representasi JSON
{
  "name": string,
  "metricType": enum (MetricType),
  "aggregateMetrics": {
    object (AggregateMetrics)
  }
}
Kolom
name

string

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

metricType

enum (MetricType)

Metrik yang nilainya diterapkan.

aggregateMetrics

object (AggregateMetrics)

Metrik untuk rentang waktu berdasarkan startDate dan endDate.

MetricType

Jenis metrik.

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

AggregateMetrics

Metrik yang digabungkan selama rentang waktu input.

Representasi JSON
{
  "missedCallsCount": integer,
  "answeredCallsCount": integer,
  "hourlyMetrics": [
    {
      object (HourlyMetrics)
    }
  ],
  "weekdayMetrics": [
    {
      object (WeekDayMetrics)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Kolom
missedCallsCount

integer

Jumlah total panggilan tak terjawab.

answeredCallsCount

integer

Jumlah total panggilan terjawab.

hourlyMetrics[]

object (HourlyMetrics)

Daftar metrik berdasarkan jam.

weekdayMetrics[]

object (WeekDayMetrics)

Daftar metrik berdasarkan hari.

startDate

object (Date)

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

endDate

object (Date)

Tanggal akhir untuk metrik ini.

HourlyMetrics

Metrik selama satu jam.

Representasi JSON
{
  "hour": integer,
  "missedCallsCount": integer
}
Kolom
hour

integer

Jam. Nilai yang diizinkan adalah 0-23.

missedCallsCount

integer

Jumlah total panggilan tak terjawab untuk jam ini.

WeekDayMetrics

Metrik untuk hari kerja.

Representasi JSON
{
  "day": enum (DayOfWeek),
  "missedCallsCount": integer
}
Kolom
day

enum (DayOfWeek)

Hari. Nilai yang diizinkan adalah Minggu - Sabtu.

missedCallsCount

integer

Jumlah total panggilan tak terjawab untuk jam ini.

DayOfWeek

Merepresentasikan hari dalam seminggu.

Enum
DAY_OF_WEEK_UNSPECIFIED Hari dalam seminggu tidak ditentukan.
MONDAY Senin
TUESDAY Selasa
WEDNESDAY Rabu
THURSDAY Kamis
FRIDAY Jumat
SATURDAY Sabtu
SUNDAY Minggu

Tanggal

Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal tersebut relatif terhadap Kalender Gregorian. Ini dapat mewakili salah satu hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol
  • Bulan dan hari, dengan nol tahun (misalnya, hari jadi)
  • Tahun saja, dengan bulan nol dan hari nol
  • Tahun dan bulan, dengan nol hari (misalnya, tanggal habis masa berlaku kartu kredit)

Jenis terkait: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp

Representasi JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dari tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.

month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.

day

integer

Hari dalam sebulan. Harus dari 1 sampai 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.