İşletme Profili araçları
Konumlar, yorumlar ve yanıtlar, gönderiler, medya, kategori ve bilgi güncellemeleri, performans içgörüleri.
Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü metnin çevirisidir, araç ve parametre adları aynen kalır.
Okuma araçları11 araç
list_gbp_locations
Okuma1 krediGoogle Business Profile konumları (ad, telefon, web sitesi, çalışma saatleri, kategori, adres, açıklama) ve konum başına eksik bilgi denetimi. Salt okunur.
Bu araç parametre almaz.
list_gbp_reviews
Okuma1 krediBir ya da tüm konumların son N güne ait yorumları (puan, metin, yanıt durumu) ve ortalama puan. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da konum adı |
daysİsteğe bağlı | integer (1–365) | — |
min_ratingİsteğe bağlı | integer (1–5) | — |
max_ratingİsteğe bağlı | integer (1–5) | — |
unreplied_onlyİsteğe bağlı | boolean | — |
limitİsteğe bağlı | integer (1–200) | reviews read per location (default 50) |
summary_onlyİsteğe bağlı | boolean | only average rating, total and unanswered count |
offsetİsteğe bağlı | integer (0–…) | skip this many matching reviews per location |
draft_gbp_review_replies
Okuma2 kredimax_rating ve altındaki (varsayılan 3 yıldız) yanıtsız yorumlar için nazik yanıt taslakları hazırlar. Hiçbir şey yayınlanmaz; taslaklar kullanıcıya gösterilir, onayladıkları için reply_gbp_review çağrılır.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da konum adı |
daysİsteğe bağlı | integer (1–365) | — |
max_ratingİsteğe bağlı | integer (1–5) | — |
toneİsteğe bağlı | string | ör. 'kısa, resmi, özür dileyen' |
gbp_insights
Okuma1 krediDönem için işletme profili istatistikleri: gösterimler (arama/haritalar), web sitesi tıklamaları, aramalar, yol tarifi istekleri, sohbetler, rezervasyonlar; konum başına ve toplam. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da konum adı |
daysİsteğe bağlı | integer (1–540) | — |
dailyİsteğe bağlı | boolean | — |
gbp_vs_ads
Okuma3 krediYerel tabloyu yan yana gösterir: Business Profile istatistikleri, Google Ads yerel kampanya harcaması/tıklamaları/dönüşümleri ve Search Console organik tıklamaları (şehir sorguları). Bağlı olmayan kaynak bunu açıkça bildirir. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da konum adı |
cityİsteğe bağlı | string | — |
daysİsteğe bağlı | integer (1–540) | — |
list_gbp_media
Okuma1 krediBir ya da tüm Business Profile konumlarındaki fotoğraf ve videolar: yerleşim kategorisi (kapak, profil, dış mekân, iç mekân, ekip…), Google URL'si, boyut, görüntülenme; ayrıca kategori başına sayı ve boş kalan önemli alanlar. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da konum adı |
categoryİsteğe bağlı | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | — |
limitİsteğe bağlı | integer (1–500) | — |
gbp_location_details
Okuma1 krediTek bir Business Profile konumuna dair her şey: başlık, adres, telefonlar, web sitesi, açıklama, kategoriler, normal çalışma saatleri, hizmet listesi, Google Haritalar bağlantısı, place id ve doğrudan 'yorum yaz' bağlantısı. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
services_limitİsteğe bağlı | integer (0–500) | — |
gbp_search_categories
Okuma1 krediGoogle'ın Business Profile kategori listesinde ada göre arar (ör. 'dentist') ve update_gbp_categories ya da gbp_create_location için kategori id'lerini (categories/gcid:…) verir. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
queryZorunlu | string | — |
regionİsteğe bağlı | string | iki harfli ülke, varsayılan TR |
languageİsteğe bağlı | string | — |
limitİsteğe bağlı | integer (1–100) | — |
gbp_search_keywords
Okuma1 krediBir konum için, kayıt görünmeden önce kullanıcıların Google Arama ve Haritalar'da kullandığı arama terimleri, aylık gösterimleriyle. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
monthsİsteğe bağlı | integer (1–18) | geçen aydan geriye tam ay sayısı (varsayılan 3) |
limitİsteğe bağlı | integer (1–500) | — |
offsetİsteğe bağlı | integer (0–…) | — |
include_low_volumeİsteğe bağlı | boolean | Google'ın yalnızca 'N'den az' olarak bildirdiği terimleri de listeler |
gbp_list_posts
Okuma1 krediBir Business Profile konumunda yayınlanmış yerel gönderiler, en yeniden eskiye: gönderi id'si, tür, metin, durum, eylem çağrısı ve bağlantı. Id'yi gbp_update_post ya da gbp_delete_post ile kullanın. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
limitİsteğe bağlı | integer (1–100) | — |
gbp_verification_options
Okuma1 krediGoogle'ın bir kayıt için sunduğu doğrulama yöntemleri (kartpostal, telefon araması, SMS, e-posta, anında), geçmiş ve bekleyen doğrulamalar ve hesabın kaydı zaten yönetip yönetmediği. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
languageİsteğe bağlı | string | — |
Yazma araçları15 araç
update_gbp_location
Yazma2 krediBir konumun telefonunu, web sitesini, normal çalışma saatlerini, özel (tatil) saatlerini, açıklamasını ya da adını günceller. Önizlemede alan, eski ve yeni değer görünür; yalnızca onaydan sonra uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
locationZorunlu | string | konum id'si, locations/ID ya da konum adı |
phoneİsteğe bağlı | string | — |
websiteİsteğe bağlı | string | — |
hoursİsteğe bağlı | object | {'pazartesi': '09:00-18:00', 'cumartesi': '10:00-14:00, 15:00-19:00', 'pazar': 'kapalı'} |
special_hoursİsteğe bağlı | array<object> | — |
descriptionİsteğe bağlı | string | — |
titleİsteğe bağlı | string | — |
additional_phonesİsteğe bağlı | array<string> | replaces the extra numbers (max 2); changing only phone keeps them |
clear_additional_phonesİsteğe bağlı | boolean | — |
address_linesİsteğe bağlı | array<string> | — |
cityİsteğe bağlı | string | — |
regionİsteğe bağlı | string | province / state |
postal_codeİsteğe bağlı | string | — |
countryİsteğe bağlı | string | two-letter country code, e.g. TR |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
reply_gbp_review
Yazma2 krediBir yoruma yanıt yayınlar (kullanıcının yazdırdığı ya da draft_gbp_review_replies taslağından onayladığı metin). Onay öğesidir; onaydan önce hiçbir şey gönderilmez.
| Parametre | Tip | Açıklama |
|---|---|---|
locationZorunlu | string | konum id'si, locations/ID ya da konum adı |
review_idZorunlu | string | — |
replyZorunlu | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_gbp_post
Yazma2 krediTüm ya da seçili konumlara bir Business Profile gönderisi (güncelleme, etkinlik, teklif ya da uyarı) yayınlar. Önce önizleme; yalnızca onaydan sonra gönderilir.
| Parametre | Tip | Açıklama |
|---|---|---|
summaryZorunlu | string | — |
topic_typeİsteğe bağlı | STANDARD | EVENT | OFFER | ALERT | — |
cta_typeİsteğe bağlı | BOOK | ORDER | SHOP | LEARN_MORE | SIGN_UP | CALL | — |
cta_urlİsteğe bağlı | string | — |
image_urlİsteğe bağlı | string | — |
locationsİsteğe bağlı | array<string> | tüm konumlar için boş bırakılır |
languageİsteğe bağlı | string | — |
event_titleİsteğe bağlı | string | — |
start_dateİsteğe bağlı | string | — |
end_dateİsteğe bağlı | string | — |
coupon_codeİsteğe bağlı | string | — |
termsİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_gbp_categories
Yazma2 krediBir konumun birincil ve/veya ek kategorilerini değiştirir. Adlar Google'ın kategori listesiyle eşleştirilir (belirsiz adlarda tahmin yerine adaylar döndürülür). Önizlemede eski ve yeni kategoriler görünür; yalnızca onaydan sonra uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
locationZorunlu | string | konum id'si, locations/ID ya da konum adı |
primary_categoryİsteğe bağlı | string | kategori görünen adı (ör. 'Diş kliniği') ya da categories/gcid:… id'si |
additional_categoriesİsteğe bağlı | array<string> | tüm ek kategorilerin yerine geçer (en fazla 9) |
add_categoriesİsteğe bağlı | array<string> | — |
remove_categoriesİsteğe bağlı | array<string> | — |
regionİsteğe bağlı | string | kategori listesi için iki harfli ülke kodu, varsayılan TR |
languageİsteğe bağlı | string | kategori adlarının dili, varsayılan kullanıcınınki |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
upload_gbp_media
Yazma2 krediHerkese açık bir URL'den bir ya da daha fazla Business Profile konumuna yerleşim kategorisiyle (kapak, profil, dış mekân, iç mekân, ürün, ekip…) fotoğraf ya da video ekler. Önce önizleme; yalnızca onaydan sonra yüklenir.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da konum adı |
locationsİsteğe bağlı | array<string> | aynı anda birden çok konum |
source_urlİsteğe bağlı | string | fotoğrafın/videonun herkese açık http(s) URL'si; Google buradan indirir |
source_urlsİsteğe bağlı | array<string> | several photos/videos in one call |
media_formatİsteğe bağlı | PHOTO | VIDEO | — |
categoryİsteğe bağlı | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | yerleşim; COVER ve PROFILE fotoğraf olmalıdır |
descriptionİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
connect_business_profile
Yazma0 krediGoogle Business Profile bağlantısını başlatır: kullanıcının açacağı tek kullanımlık bir yetkilendirme bağlantısı döndürür (connect_account ile aynı akış). Kullanıcı oturum açana kadar hiçbir şey bağlanmaz.
Bu araç parametre almaz.
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
gbp_create_location
Yazma5 krediYENİ bir Business Profile kaydı oluşturur (Haritalar/Arama'da yeni bir işletme). Önizleme kaydı birebir gösterir; yalnızca onaydan sonra oluşturulur ve görünmeden önce yine doğrulama (gbp_verification_options) gerekir.
| Parametre | Tip | Açıklama |
|---|---|---|
titleZorunlu | string | — |
address_linesZorunlu | array<string> | — |
cityİsteğe bağlı | string | — |
regionİsteğe bağlı | string | — |
postal_codeİsteğe bağlı | string | — |
countryZorunlu | string | iki harfli ülke kodu, ör. TR |
primary_categoryZorunlu | string | kategori adı ya da categories/gcid:… (gbp_search_categories) |
phoneİsteğe bağlı | string | — |
websiteİsteğe bağlı | string | — |
hoursİsteğe bağlı | object | {'pazartesi': '09:00-18:00', 'pazar': 'kapalı'} |
descriptionİsteğe bağlı | string | — |
accountİsteğe bağlı | string | Business Profile hesabı; varsayılan bağlı hesap |
languageİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
gbp_start_verification
Yazma3 krediBir kaydı gbp_verification_options'taki yöntemlerden biriyle doğrulamaya başlar. Onay öğesidir; ardından Google bir kod gönderir ve kod gbp_complete_verification ile girilir.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
methodZorunlu | ADDRESS | EMAIL | PHONE_CALL | SMS | AUTO | — |
phoneİsteğe bağlı | string | PHONE_CALL / SMS için |
emailİsteğe bağlı | string | EMAIL için |
mailer_contactİsteğe bağlı | string | kartpostalın alıcı adı (ADDRESS) |
languageİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
gbp_complete_verification
Yazma2 krediBekleyen bir doğrulamayı Google'ın gönderdiği PIN ile tamamlar (kartpostal, SMS, arama ya da e-posta). Onay öğesidir; PIN önizlemede maskelenir.
| Parametre | Tip | Açıklama |
|---|---|---|
verificationZorunlu | string | doğrulama adı locations/…/verifications/… ya da id'si |
pinZorunlu | string | — |
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
gbp_manage_services
Yazma3 krediBir konumun Hizmetler listesine hizmet ekler, çıkarır ya da listeyi değiştirir (serbest ad ya da Google'ın önceden tanımlı hizmet id'si; isteğe bağlı açıklama ve fiyatla). Önizleme eski ve yeni listeyi gösterir; yalnızca onaydan sonra uygulanır. Mevcut liste gbp_location_details'te.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
actionZorunlu | add | remove | replace | — |
servicesZorunlu | array<object> | — |
languageİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
gbp_social_links
Yazma2 krediBir Business Profile'daki sosyal medya ve randevu bağlantılarını okur ya da ayarlar (Instagram, Facebook, X, LinkedIn, YouTube, TikTok, Pinterest, WhatsApp, randevu). links/remove olmadan yalnızca okur; değişiklikler eski ve yeni bağlantıları gösteren bir onay öğesi açar.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
linksİsteğe bağlı | object | {platform: url}; platformlar: instagram, facebook, twitter, linkedin, youtube, tiktok, pinterest, whatsapp, appointment |
removeİsteğe bağlı | array<string> | bağlantısı kaldırılacak platformlar |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
gbp_update_post
Yazma3 krediYayınlanmış bir Business Profile gönderisini silmeden yerinde düzenler (metin ve/veya eylem çağrısı düğmesi). Önce önizleme; yalnızca onaydan sonra uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
postZorunlu | string | gbp_list_posts'tan gönderi id'si ya da tam adı |
summaryİsteğe bağlı | string | — |
cta_typeİsteğe bağlı | BOOK | ORDER | SHOP | LEARN_MORE | SIGN_UP | CALL | — |
cta_urlİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
gbp_delete_post
YazmaGeri alınamaz2 krediBir Business Profile gönderisini KALICI olarak siler. Asla otomatik uygulanmaz: her zaman kullanıcının açık onayını bekler.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
postZorunlu | string | gbp_list_posts'tan gönderi id'si ya da tam adı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
gbp_update_photo_category
Yazma2 krediProfilde zaten bulunan bir fotoğrafı, görüntülenmelerini ve geçmişini koruyarak yerinde başka bir yerleşim kategorisine (kapak, profil, dış mekân, iç mekân…) taşır. Önce önizleme; yalnızca onaydan sonra uygulanır.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
media_idZorunlu | string | list_gbp_media'dan media_key |
categoryZorunlu | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
gbp_delete_photo
YazmaGeri alınamaz2 krediBir Business Profile'dan fotoğraf ya da videoyu KALICI olarak siler. Asla otomatik uygulanmaz: her zaman kullanıcının açık onayını bekler.
| Parametre | Tip | Açıklama |
|---|---|---|
locationİsteğe bağlı | string | konum id'si, locations/ID ya da başlık; boş bırakılırsa seçili (ya da tek) konum kullanılır |
media_idZorunlu | string | list_gbp_media'dan media_key |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.