- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme Kapsamları
- BusinessCallsInsights
- MetricType
- AggregateMetrics
- HourlyMetrics
- WeekDayMetrics
- DayOfWeek
- Tarih
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 |
Zorunlu. Arama analizlerinin alınacağı üst konum. Biçim: locations/{locationId} |
Sorgu parametreleri
Parametreler | |
---|---|
pageSize |
İ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 |
İsteğe bağlı. Önceki bir Sayfalara ayırma sırasında |
filter |
İ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 ( |
Alanlar | |
---|---|
businessCallsInsights[] |
Konuma ilişkin arama analizleri koleksiyonu. |
nextPageToken |
Sonraki sayfayı almak için |
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 ( |
Alanlar | |
---|---|
name |
Zorunlu. Arama analizlerinin kaynak adı. Biçim: locations/{location}/businesscallsinsights |
metricType |
Değerin geçerli olduğu metrik. |
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 ( |
Alanlar | |
---|---|
missedCallsCount |
Cevapsız aramaların toplam sayısı. |
answeredCallsCount |
Yanıtlanmış aramaların toplam sayısı. |
hourlyMetrics[] |
Günün saatine göre metriklerin listesi. |
weekdayMetrics[] |
Haftanın gününe göre metriklerin listesi. |
startDate |
Bu metrik için tarih. Metrik aylıksa yalnızca yıl ve ay kullanılır. |
endDate |
Bu metrik için bitiş tarihi. |
HourlyMetrics
Bir saat için metrikler.
JSON gösterimi |
---|
{ "hour": integer, "missedCallsCount": integer } |
Alanlar | |
---|---|
hour |
Günün saati. İzin verilen değerler 0 ile 23 arasındadır. |
missedCallsCount |
Bu saatteki toplam cevapsız arama sayısı. |
WeekDayMetrics
Haftanın gününe ait metrikler.
JSON gösterimi |
---|
{
"day": enum ( |
Alanlar | |
---|---|
day |
Haftanın günleri. Pazar - Cumartesi günleri izin verilir. |
missedCallsCount |
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 |
Tarihin yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır. |
month |
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 |
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. |