Method: locations.businesscallsinsights.list

Bir konuma ilişkin İşletme aramalarıyla ilgili 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: locations/{locationId}

Sorgu parametreleri

Parametreler
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum BusinessCallsInsights sayısı. Belirtilmezse en fazla 20 sonuç döndürülür. Metric_types'dan bazıları(ör.AGGREGATE_COUNT) tek bir sayfa döndürür. Bu metrikler için pageSize yok sayılır.
pageToken

string

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

Sayfalara ayırma sırasında businesscallsinsights.list için sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Bazımetric_types (ö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 sınırlayan 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ğlanmamışsa varsayılan olarak verilerin kullanılabilir olduğu ilk tarihi kullanırız. Bu tarih şu anda 6 aydır. startDate, verilerin kullanılabilir olduğu tarihten önceyse veriler kullanılabilir oldukları tarihten itibaren döndürülür.

Şu anda aşağıdaki filtreleri destekliyoruz. 1. startDate="TARİH"; tarih, YYYY-AA-GG biçimindedir. 2. endDate="TARİH"; 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ğlantıları(VE). ör. "startDate=2021-08-01 AND endDate=2021-08-10 ANDmetricType=AGGREGATE_COUNT" AGGREGATE_COUNTmetricType, tarihin DD 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)

Konuma ilişkin arama analizleri koleksiyonu.
nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilecek bir jeton. Bu alan atlanırsa, başka bir sayfa gösterilmez. Bazımetric_types (ör.AGGREGATE_COUNT) tek bir sayfa döndürür. Bu metrikler için nextPageToken boş olur.

Yetkilendirme Kapsamları

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

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

BusinessCallsInsights

Bir konuma yapılan telefon aramalarıyla ilgili analizler.

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

string

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

enum (MetricType)

Değerin geçerli olduğu metrik.
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ığı boyunca 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

Cevapsız aramaların toplam sayısı.
answeredCallsCount

integer

Yanıtlanmış 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 metrik için tarih. Metrik aylıksa yalnızca yıl ve ay kullanılır.
endDate

object (Date)

Bu metrik için bitiş tarihi.

HourlyMetrics

Bir saat için 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 gününe ait metrikler.

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

enum (DayOfWeek)

Haftanın günleri. Pazar - Cumartesi günleri izin verilir.
missedCallsCount

integer

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

DayOfWeek

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

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

Tarih

Takvim tarihinin tamamını veya bir kısmını (ör. doğum günü) temsil eder. Günün saati ve saat dilimi, başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim ile görecelidir. Aşağıdakilerden birini gösterebilir:

  • Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih
  • Sıfır yıllı bir ay ve gün (ör. yıl dönümü)
  • Tek başına bir yıl (sıfır ay ve sıfır gün)
  • Sıfır gün içeren bir yıl ve ay (ö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 tarih belirtmek için 0 olmalıdır.
month

integer

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

integer

Ayın günü. 1 ile 31 arasında olup yıl ve ay için geçerli olmalıdır veya tek başına yıl ya da günün önemli olmadığı yıl ve ay belirtmek için 0 olmalıdır.