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 jenis_metrik(misalnya, AGGREGATE_COUNT) menampilkan satu halaman. Untuk metrik ini, pageSize diabaikan.

pageToken

string

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

Saat memberi nomor halaman, semua parameter lain yang diberikan ke businesscallsinsights.list harus cocok dengan panggilan yang menyediakan token halaman. Beberapa jenis_metrik (misalnya, AGGREGATE_COUNT) menampilkan satu halaman. Untuk metrik ini, pake_token diabaikan.

filter

string

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

Jika MetricType tidak tersedia, AGGREGATE_COUNT akan ditampilkan. Jika tidak ada endDate yang diberikan, tanggal terakhir untuk data yang tersedia akan digunakan. Jika startDate tidak diberikan, secara default kami akan menggunakan tanggal pertama yang datanya tersedia, yaitu 6 bulan. Jika startDate jatuh 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 yang di atas. misalnya, "startDate=2021-08-01 AND endDate=2021-08-10 AND metricType=AGGREGATE_COUNT" AGGREGATE_COUNT metricType mengabaikan bagian DD pada tanggal.

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 jenis_metrik (misalnya, AGGREGATE_COUNT) menampilkan satu halaman. Untuk metrik ini, nextPageToken akan kosong.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

BusinessCallsInsights

Insight 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 berlaku.

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 diberikan merupakan jumlah yang digabungkan selama rentang_waktu input.

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 menurut jam.

weekdayMetrics[]

object (WeekDayMetrics)

Daftar metrik menurut 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 untuk 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.

Enum
DAY_OF_WEEK_UNSPECIFIED Hari 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 ini relatif terhadap Kalender Gregorian. ID ini dapat mewakili salah satu dari hal berikut:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi)
  • Setahun sendirian, dengan bulan nol dan hari nol
  • Tahun dan bulan, dengan hari nol (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 dalam 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 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.