Method: locations.businesscallsinsights.list

Bir konum için yapılan İşletme çağrılarına ait analizleri döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Arama analizlerinin alınacağı üst konum. Biçim: konumlar/{locationId}

Sorgu parametreleri

Parametreler
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum BusinessCallsInsights sayısı. Belirtilmemişse en fazla 20 öğe döndürülür. column_types [metrik_türlerinden bazıları] (ör.AGGREGATE_COUNT) tek bir sayfa döndürür. Bu metrikler için pageSize öğesi yoksayılır.

pageToken

string

İsteğe bağlı. Önceki businesscallsinsights.list çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi sırasında businesscallsinsights.list öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. column_types [metrik_türlerinden bazıları] (ör.AGGREGATE_COUNT) tek bir sayfa döndürür. Bu metrikler için pake_token yoksayılır.

filter

string

İsteğe bağlı. Döndürülecek arama analizlerini kısıtlayan bir filtre. Yanıt yalnızca filtreyle eşleşen girişleri içerir.

MetricType sağlanmazsa AGGREGATE_COUNT döndürülür. endDate sağlanmazsa verilerin mevcut olduğu son tarih kullanılır. startDate sağlanmazsa varsayılan olarak verilerin mevcut olduğu ilk tarih kullanılır. Bu tarih şu anda 6 aydır. startDate, verilerin kullanılabilir olduğu tarihten önceyse veriler kullanılabilir oldukları tarihten başlayarak döndürülür.

Şu anda aşağıdaki filtreleri destekliyoruz. 1. startDate="TARİH" Bu örnekte tarih YYYY-AA-GG biçimindedir. 2. endDate="TARİH" Bu örnekte tarih YYYY-AA-GG biçimindedir. 3. metricType=XYZ, burada XYZ geçerli bir MetricType'tır. 4. Yukarıdakilerin tümünün bağlaçları(VE). ör. "startDate=2021-08-01 AND endDate=2021-08-10 AND metricType=AGGREGATE_COUNT" AGGREGATE_COUNT metricType, tarihin GG bölümünü yoksayar.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

businesscallsinsights.list için yanıt mesajı.

JSON gösterimi
{
  "businessCallsInsights": [
    {
      object (BusinessCallsInsights)
    }
  ],
  "nextPageToken": string
}
Alanlar
businessCallsInsights[]

object (BusinessCallsInsights)

Konumla ilgili işletme arama analizlerinin bir koleksiyonu.

nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilecek bir jeton. Bu alan atlanırsa sonraki sayfa olmaz. column_types [metrik_türlerinden bazıları] (ör.AGGREGATE_COUNT) tek bir sayfa döndürür. Bu metrikler için nextPageToken boş olacaktır.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

BusinessCallsInsights

Bir konuma yapılan aramalarla ilgili analizler.

JSON gösterimi
{
  "name": string,
  "metricType": enum (MetricType),
  "aggregateMetrics": {
    object (AggregateMetrics)
  }
}
Alanlar
name

string

Zorunlu. Arama analizlerinin kaynak adı. Biçim: konumlar/{location}/businesscallsinsights

metricType

enum (MetricType)

Değerin geçerli olduğu metriktir.

aggregateMetrics

object (AggregateMetrics)

startDate ve endDate'e dayalı olarak zaman aralığı metriği.

MetricType

Metriğin türü.

Sıralamalar
METRIC_TYPE_UNSPECIFIED Metrik türü belirtilmedi.
AGGREGATE_COUNT Sağlanan metrikler, giriş zaman_aralığı üzerinden toplanan sayılardır.

AggregateMetrics

Giriş zaman aralığında toplanan metrikler.

JSON gösterimi
{
  "missedCallsCount": integer,
  "answeredCallsCount": integer,
  "hourlyMetrics": [
    {
      object (HourlyMetrics)
    }
  ],
  "weekdayMetrics": [
    {
      object (WeekDayMetrics)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Alanlar
missedCallsCount

integer

Toplam cevapsız arama sayısı.

answeredCallsCount

integer

Yanıtlanan aramaların toplam sayısı.

hourlyMetrics[]

object (HourlyMetrics)

Günün saatine göre metriklerin listesi.

weekdayMetrics[]

object (WeekDayMetrics)

Haftanın gününe göre metriklerin listesi.

startDate

object (Date)

Bu metriğin tarihi. Metrik aylıksa yalnızca yıl ve ay kullanılır.

endDate

object (Date)

Bu metriğin bitiş tarihi.

HourlyMetrics

Bir saate ait metrikler.

JSON gösterimi
{
  "hour": integer,
  "missedCallsCount": integer
}
Alanlar
hour

integer

Günün saati. İzin verilen değerler 0 ile 23 arasındadır.

missedCallsCount

integer

Bu saatteki toplam cevapsız arama sayısı.

WeekDayMetrics

Haftanın bir gününe ait metrikler.

JSON gösterimi
{
  "day": enum (DayOfWeek),
  "missedCallsCount": integer
}
Alanlar
day

enum (DayOfWeek)

Haftanın günleri. İzin verilen değerler Pazar-Cumartesi günleridir.

missedCallsCount

integer

Bu saatteki toplam cevapsız arama sayısı.

HaftanınGünü

Haftanın bir gününü temsil eder.

Sıralamalar
DAY_OF_WEEK_UNSPECIFIED Haftanın günü belirtilmemiş.
MONDAY Pazartesi
TUESDAY Salı
WEDNESDAY Çarşamba
THURSDAY Perşembe
FRIDAY Cuma
SATURDAY Cumartesi
SUNDAY Pazar

Tarih

Takvimin tamamını veya bir kısmını temsil eder (ör. doğum günü). Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih
  • Bir ay ve gün ile sıfır yıl (ör. yıl dönümü)
  • Tek başına bir yıl, sıfır ay ve sıfır gün
  • Bir yıl ve ay, sıfır gün (ör. kredi kartı son kullanma tarihi)

İlgili türler: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp

JSON gösterimi
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarihi belirtmek için 0 arasında olmalıdır.

month

integer

Bir yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 arasında olmalıdır.

day

integer

Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Yalnızca yılı belirtmek için 0 değerini veya günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değerini girin.