Package google.mybusiness.businesscalls.v1

Dizin

BusinessCallsService

Bu API, işletmelerin işletme aramalarını yönetmesine ve konumlarına yapılan cevapsız aramaların sayısı gibi analizler toplamasına olanak tanır. İşletme aramalarıyla ilgili ek bilgileri https://support.google.com/business/answer/9688285?p=call_history adresinde bulabilirsiniz.

Google İşletme Profili bir Google Ads hesabına bağlanıyor ve çağrı geçmişi etkinse belirli bir süreden daha uzun süren ve bir reklam etkileşimiyle ilişkilendirilebilen aramalar, bağlı Google Ads hesabındaki "Reklamlardan gelen telefon aramaları" dönüşümü altında gösterilir. Optimizasyon stratejisinde akıllı teklif ve telefon araması dönüşümleri kullanılıyorsa reklam harcamalarında bir değişiklik olabilir. Akıllı Teklif hakkında daha fazla bilgi edinin."

Bir konuma gelen aramaları görüntülemek ve bunlarla ilgili işlem gerçekleştirmek için konumun OWNER, CO_OWNER veya MANAGER olması gerekir.

GetBusinessCallsSettings

rpc GetBusinessCallsSettings(GetBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

Belirli bir konum için İşletme çağrıları ayarları kaynağını döndürü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'a Genel Bakış başlıklı makaleye bakın.
ListBusinessCallsInsights

rpc ListBusinessCallsInsights(ListBusinessCallsInsightsRequest) returns (ListBusinessCallsInsightsResponse)

Bir konuma ilişkin İşletme aramalarıyla ilgili analizleri döndürü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'a Genel Bakış başlıklı makaleye bakın.
UpdateBusinessCallsSettings

rpc UpdateBusinessCallsSettings(UpdateBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

Belirtilen konum için İş görüşmesi ayarlarını günceller.

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.

AggregateMetrics

Giriş zaman aralığında toplanan metrikler.

Alanlar
missed_calls_count

Int32Value

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

Int32Value

Yanıtlanmış aramaların toplam sayısı.
hourly_metrics[]

HourlyMetrics

Günün saatine göre metriklerin listesi.
weekday_metrics[]

WeekDayMetrics

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

Date

Bu metrik için tarih. Metrik aylıksa yalnızca yıl ve ay kullanılır.
end_date

Date

Bu metrik için bitiş tarihi.

BusinessCallsInsights

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

Alanlar
name

string

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

MetricType

Değerin geçerli olduğu metrik.
aggregate_metrics

AggregateMetrics

start_date ve end_date'e dayalı zaman aralığı metriği.

BusinessCallsSettings

Bir konuma ilişkin işletme arama ayarları.

Alanlar
name

string

Zorunlu. Çağrı ayarlarının kaynak adı. Biçim: locations/{location}/businesscallssettings
calls_state

CallsState

Zorunlu. Bu konumun İşletme aramalarındaki kaydının durumu.
consent_time

Timestamp

Yalnızca giriş. Son kullanıcının, iş aramalarının etkinleştirilmesi için API kullanıcısına izin verdiği zamandır.

CallsState

İşletme telefonlarındaki bir konumun olası durumları. Durumlar yalnızca ETKİN veya DEVRE DIŞI olarak güncellenebilir. Başka değerler PRECondition_FAILED hatası döndürür.

Sıralamalar
CALLS_STATE_UNSPECIFIED Belirtilmedi.
ENABLED İşletme aramaları konum için etkinleştirildi.
DISABLED İşletme aramaları bu konum için devre dışı bırakıldı.

ErrorCode

Dahili hatalar için hata kodları.

Sıralamalar
ERROR_CODE_UNSPECIFIED Belirtilmemiş hata kodu.
ERROR_CODE_UNVERIFIED_LOCATION Konum doğrulanmamış.
ERROR_CODE_CALLS_NOT_ENABLED Konum için "İşletme aramaları" durumu ETKİN değil.
ERROR_CODE_NOT_ELIGIBLE_LOCATION Konum, işletme aramaları için uygun değil.

GetBusinessCallsSettingsRequest

GetBusinessCallsSettings için mesaj isteyin.

Alanlar
name

string

Zorunlu. Alınacak BusinessCallsSettings.

name alanı, alınacak işletme araması ayarlarını tanımlamak için kullanılır. Biçim: konumlar/{location_id}/businesscallssettings.

HourlyMetrics

Bir saat için metrikler.

Alanlar
hour

Int32Value

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

Int32Value

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

ListBusinessCallsInsightsRequest

ListBusinessCallsInsights için ileti isteyin.

Alanlar
parent

string

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

int32

İ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 page_size yok sayılır.
page_token

string

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

Sayfalara ayırma sırasında ListBusinessCallsInsights 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. Bir bitiş_tarihi sağlanmazsa verilerin mevcut olduğu son tarih kullanılır. Bir başlangıç_tarihi sağlanmazsa varsayılan olarak verilerin kullanılabilir olduğu ilk tarihi kullanırız. Bu tarih şu anda 6 aydır. start_date, 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. start_date="DATE", tarih YYYY-AA-GG biçimindedir. 2. end_date="DATE", YYYY-AA-GG biçiminde belirtilir. 3.metric_type=XYZ. Burada XYZ, geçerli bir MetricType'tır. 4. Yukarıdakilerin tümünün bağlantıları(VE). ör. "start_date=2021-08-01 AND end_date=2021-08-10 ANDmetric_type=AGGREGATE_COUNT" AGGREGATE_COUNTmetric_type, tarihin DD bölümünü yoksayar.

ListBusinessCallsInsightsResponse

ListBusinessCallsInsights için yanıt mesajı.

Alanlar
business_calls_insights[]

BusinessCallsInsights

Konuma ilişkin arama analizleri koleksiyonu.
next_page_token

string

Sonraki sayfayı almak için page_token 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 next_page_token boş olur.

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.

UpdateBusinessCallsSettingsRequest

UpdateBusinessCallsSettings için mesaj isteyin.

Alanlar
business_calls_settings

BusinessCallsSettings

Zorunlu. Güncellenecek BusinessCallsSettings.

name alanı, güncellenecek iş araması ayarlarını tanımlamak için kullanılır. Biçim: konumlar/{location_id}/businesscallssettings
update_mask

FieldMask

Zorunlu. Güncellenecek alanların listesi.

WeekDayMetrics

Haftanın gününe ait metrikler.

Alanlar
day

DayOfWeek

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

Int32Value

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