Package google.mybusiness.performance.v1

Dizin

• PerformanceService (arayüz)
• DailyMetric (enum)
• DailyMetricTimeSeries (message)
• DailyRange (message)
• DailySubEntityType (message)
• DatedValue (message)
• FetchMultiDailyMetricsTimeSeriesRequest (message)
• FetchMultiDailyMetricsTimeSeriesResponse (message)
• GetDailyMetricsTimeSeriesRequest (message)
• GetDailyMetricsTimeSeriesResponse (message)
• InsightsValue (message)
• ListSearchKeywordImpressionsMonthlyRequest (message)
• ListSearchKeywordImpressionsMonthlyResponse (message)
• MonthlyRange (message)
• MultiDailyMetricTimeSeries (message)
• SearchKeywordCount (message)
• TimeSeries (message)

PerformanceService

Bu hizmet, satıcıların Google'daki işletme profilleriyle ilgili performans raporlarını getirmesine olanak tanır.

API, aip.dev'de bulunan yönergelere uymaya çalışıyor.

FetchMultiDailyMetricsTimeSeries

rpc FetchMultiDailyMetricsTimeSeries(FetchMultiDailyMetricsTimeSeriesRequest) returns (FetchMultiDailyMetricsTimeSeriesResponse) Belirli bir zaman aralığından her bir tarihe ilişkin değerleri ve isteğe bağlı olarak belirli günlük metriklerle ilişkilendirilen alt varlık türünü (geçerli olduğu durumlarda) döndürür. Örnek istek: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:fetchMultiDailyMetricsTimeSeries?dailyMetrics=WEBSITE_CLICKS&dailyMetrics=CALL_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31 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.

GetDailyMetricsTimeSeries

rpc GetDailyMetricsTimeSeries(GetDailyMetricsTimeSeriesRequest) returns (GetDailyMetricsTimeSeriesResponse) Belirli bir günlük metrikle ilişkilendirilmiş belirli bir zaman aralığındaki her tarihin değerlerini döndürür. Örnek istek: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31 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.

ListSearchKeywordImpressionsMonthly

rpc ListSearchKeywordImpressionsMonthly(ListSearchKeywordImpressionsMonthlyRequest) returns (ListSearchKeywordImpressionsMonthlyResponse) Aramada veya haritalarda bir işletmeyi bulmak için kullanılan arama anahtar kelimelerini döndürür. Her bir arama ağı anahtar kelimesine, aylık olarak toplanan gösterimler eşlik eder. Örnek istek: GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1&monthly_range.end_month.year=2022&monthly_range.end_month.month=3 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.

DailyMetric

Bir işletmeye ilişkin mevcut tüm günlük metrikleri temsil eder.

Sıralamalar
DAILY_METRIC_UNKNOWN	Varsayılan bilinmeyen değeri temsil eder.
BUSINESS_IMPRESSIONS_DESKTOP_MAPS	Masaüstü cihazlarda Google Haritalar'daki işletme gösterimleri. Benzersiz bir kullanıcının tek bir gün içinde birden fazla gösterimi tek bir gösterim olarak sayılır.
BUSINESS_IMPRESSIONS_DESKTOP_SEARCH	Masaüstü cihazlarda Google Arama'daki işletme gösterimleri. Benzersiz bir kullanıcının tek bir gün içinde birden fazla gösterimi tek bir gösterim olarak sayılır.
BUSINESS_IMPRESSIONS_MOBILE_MAPS	Mobil cihazlarda Google Haritalar'daki işletme gösterimleri. Benzersiz bir kullanıcının tek bir gün içinde birden fazla gösterimi tek bir gösterim olarak sayılır.
BUSINESS_IMPRESSIONS_MOBILE_SEARCH	Mobil cihazlarda Google Arama'daki işletme gösterimleri. Benzersiz bir kullanıcının tek bir gün içinde birden fazla gösterimi tek bir gösterim olarak sayılır.
BUSINESS_CONVERSATIONS	İşletme Profili'nde alınan mesaj görüşmelerinin sayısı.
BUSINESS_DIRECTION_REQUESTS	İşletmenin bulunduğu konuma yapılan yol tarifi isteğinin sayısı.
CALL_CLICKS	İşletme profilindeki arama düğmesinin tıklanma sayısı.
WEBSITE_CLICKS	İşletme profili web sitesinin tıklanma sayısı.
BUSINESS_BOOKINGS	Google ile Rezervasyon aracılığıyla işletme profilinden yapılan rezervasyonların sayısıdır.
BUSINESS_FOOD_ORDERS	İşletme Profili'nden alınan yemek siparişlerinin sayısı.
BUSINESS_FOOD_MENU_CLICKS	İşletme Profilindeki menü içeriğini görüntülemek veya bu içerikle etkileşim kurmak için tıklama sayısı. Benzersiz bir kullanıcının tek bir gün içinde birden fazla tıklaması 1 olarak sayılır.

DailyMetricTimeSeries

Her veri noktasının bir DailyMetric-DailySubEntityType-TimeSeries demeti olduğu tek bir veri noktasını temsil eder.

Alanlar
daily_metric	DailyMetric TimeSeries'in temsil ettiği DailyMetric.
daily_sub_entity_type	DailySubEntityType TimeSeries'in temsil ettiği DailySubEntityType. Döküm olmadığında mevcut olmaz.
time_series	TimeSeries Her veri noktasının tarih-değer çifti olduğu veri noktalarının listesi.

DailyRange

Bir tarih aralığını (her ikisi de dahil) gösteren zaman aralığı.

Alanlar
start_date	Date Zorunlu. Kapsayıcı
end_date	Date Zorunlu. Kapsayıcı

DailySubEntityType

DailyMetrics ile ilişkilendirilmiş tüm olası alt varlık türlerini temsil eder.

Alanlar
Type alanı. Aşağıdaki proto alanlarından yalnızca birinin olması gerektiğini gösterir. DailySubEntityType tüm metriklerde kullanılamaz. Type şunlardan yalnızca biri olabilir:
day_of_week	DayOfWeek Haftanın gününü temsil eder. Ör. MONDAY. Şu anda desteklenen DailyMetrics = NONE.
time_of_day	TimeOfDay Günün saatini 24 saat biçiminde gösterir. Ör. 13:34:20 Şu anda desteklenen DailyMetrics = NONE.

DatedValue

Zaman serisinde, her veri noktası bir tarih-değer çifti olan tek bir veri noktasını temsil eder.

Alanlar
date	Date Veri noktasının karşılık geldiği tarih. Gün alanı ayarlanmazsa bu ay değerini temsil eder.
value	int64 Veri noktasının değeri. Değer sıfır olduğunda bu mevcut olmayacaktır.

FetchMultiDailyMetricsTimeSeriesRequest

FetchMultiDailyMetricsTimeSeries isteğini temsil eder.

Alanlar
location	string Zorunlu. Zaman serisinin getirilmesi gereken konum. Biçim: location_id değerinin karartılmamış bir giriş kimliği olduğu konumlar/{location_id}.
daily_metrics[]	DailyMetric Zorunlu. Zaman serisi alınacak metrikler.
daily_range	DailyRange Zorunlu. Zaman serisinin getirileceği zaman aralığı.

FetchMultiDailyMetricsTimeSeriesResponse

FetchMultiDailyMetricsTimeSeries yanıtını temsil eder.

Alanlar
multi_daily_metric_time_series[]	MultiDailyMetricTimeSeries DailyMetrics ve karşılık gelen zaman serileri.

GetDailyMetricsTimeSeriesRequest

GetDailyMetricsTimeSeries isteğini temsil eder.

Alanlar
name	string Zorunlu. Zaman serisinin getirilmesi gereken konum. Biçim: location_id değerinin karartılmamış bir giriş kimliği olduğu konumlar/{location_id}.
daily_metric	DailyMetric Zorunlu. Zaman serisi alınacak metrik.
daily_range	DailyRange Zorunlu. Zaman serisinin getirileceği zaman aralığı.
daily_sub_entity_type	DailySubEntityType İsteğe bağlı. Zaman serisinin ilgili olduğu alt varlık türü ve kimliği. Şu anda desteklenen DailyMetrics = NONE.

GetDailyMetricsTimeSeriesResponse

GetDailyMetricsTimeSeries yanıtını temsil eder.

Alanlar
time_series	TimeSeries Günlük zaman serisi.

InsightsValue

Bir analiz değerini temsil eder.

Alanlar
InsightsValue alanı. Aşağıdaki proto alanlarından yalnızca birinin olması gerektiğini gösterir. InsightsValue şunlardan yalnızca biri olabilir:
value	int64 Gerçek değeri temsil eder.
threshold	int64 Gerçek değerin altına düştüğü eşiği temsil eder.

ListSearchKeywordImpressionsMonthlyRequest

ListSearchKeywordImpressionsAylık isteğini temsil eder.

Alanlar
parent	string Zorunlu. Zaman serisinin getirilmesi gereken konum. Biçim: location_id değerinin karartılmamış bir giriş kimliği olduğu konumlar/{location_id}.
monthly_range	MonthlyRange Zorunlu. Arama ağı anahtar kelimesi gösterimlerinin toplanacağı ay aralığı.
page_size	int32 İsteğe bağlı. İstenen sonuçların sayısı. Varsayılan sayfa boyutu 100'dür. Sayfa boyutu en fazla 100 tane olacak şekilde ayarlanabilir.
page_token	bytes İsteğe bağlı. Döndürülecek sonraki sayfalara ayrılmış sonucu belirten jeton.

ListSearchKeywordImpressionsMonthlyResponse

ListSearchKeywordImpressionsaylık için verilen yanıtı temsil eder.

Alanlar
search_keywords_counts[]	SearchKeywordCount Bir işletmeyi bulmak için kullanılan arama terimleri.
next_page_token	bytes Sayfalara ayrılmış son sonucu belirten bir jeton. Bu anahtar kelime, sonraki anahtar kelime "sayfasını" almak için yapılan başarılı istekler tarafından kullanılabilir. Yalnızca döndürülecek daha fazla sonuç olduğunda mevcuttur.

MonthlyRange

Bir ay aralığını (her ikisi de dahil) gösteren zaman aralığı.

Alanlar
start_month	Date Zorunlu. Kapsayıcı - Yalnızca yıl ve ay alanları dikkate alınır
end_month	Date Zorunlu. Kapsayıcı - Yalnızca yıl ve ay alanları dikkate alınır

MultiDailyMetricTimeSeries

DailyMetric-DailySubEntityType-TimeSeries öğelerinin bir listesini temsil eder.

Alanlar
daily_metric_time_series[]	DailyMetricTimeSeries DailyMetric-TimeSeries çiftlerinin listesi.

SearchKeywordCount

Tek bir arama anahtar kelimesini ve bu anahtar kelimenin değerini temsil eder.

Alanlar
search_keyword	string Kullanıcının girdiği, küçük harfli dize.
insights_value	InsightsValue Şunlardan biri: 1) Anahtar kelimeyi bir ay içinde kullanan benzersiz kullanıcıların sayısının toplamı, istenen her ay için toplanır. 2) Gerçek değerin bu eşiğin altında olduğunu gösteren bir eşik.

TimeSeries

Zaman serisini temsil eder.

Alanlar
dated_values[]	DatedValue Her veri noktasının bir tarih-değer çifti olduğu zaman serisindeki veri noktalarının listesi.