İçeriğe atla
OrqLabs

Google İşletme Profili (Business Profile)

Google yorumlarını yanıtlama, haftalık yerel gönderi yayınlama ve Haritalar/Arama performansı. API erişim onayı, konum seçimi ve 1–3 yıldız kuralı.

10 dk Son güncelleme:
Bu sayfada
  1. Kimlik kartı
  2. Ne işe yarar?
  3. Önemli: API erişim onayı
  4. Ön koşullar
  5. Adım adım kurulum
  6. A) Google Cloud Console (platform yöneticisi)
  7. B) OrqLabs'ta bağlama
  8. Yorum yanıtlama kuralları
  9. Yerel gönderiler
  10. İzinler ve kapsamlar
  11. Sık karşılaşılan hatalar
  12. Sonraki adım

Bu rehberde: İşletmenizin Google profilini OrqLabs'a bağlarsınız. Ajanlar Google yorumlarını yanıtlar, haftalık yerel gönderi hazırlar ve Haritalar/Arama performansını Analitik sayfasına taşır.

⏱ 10 dakika (platformun Google API erişimi onaylıysa)

Kimlik kartı

AlanDeğer
Sağlayıcı anahtarıGOOGLE_BUSINESS_PROFILE (kutularda platform: Google Business Profile)
KategoriAnalitik ve yerel pazarlama
Kimlik doğrulamaİzin ekranı (Google) + bağlandıktan sonra İşletme konumu seçimi
KapsamProje bazlı (bir bağlantı = bir konum)
WebhookHayır (yorumlar düzenli aralıkla okunur)
YeteneklerYorum okuma ve yanıtlama, yerel gönderi yayınlama, performans okuma
Kullanan kutularYorumları al, Yoruma yanıt ver, Gönderi yayınla
Kullanan ajanlarTopluluk Yöneticisi, İçerik Üretici, Sosyal Yayıncı

Ne işe yarar?

  • Yorumlar: Google yorumları diğer platformlardaki yorumlar gibi işlenir; her yorumun yıldız puanı (1–5) da gelir. Topluluk Yöneticisi 4–5 yıldızlı yorumlara marka sesinizle kısa bir teşekkür yazar.
  • Yerel gönderiler: Güncelleme, etkinlik veya kampanya gönderisi (en fazla 1.500 karakter, bir fotoğraf, isteğe bağlı düğme: Daha fazla bilgi, Rezervasyon, Sipariş, Satın al, Kaydol, Ara).
  • Performans: Haritalar ve Arama görüntülenmeleri, web sitesi tıklamaları, telefon aramaları ve yol tarifi istekleri günlük olarak Analitik → Google İşletme sekmesine gelir.

Önemli: API erişim onayı

Google bu API'yi herkese açmaz. Yeni bir Google Cloud projesinin kotası 0'dır; Google erişim başvurusunu onaylayana kadar hiçbir istek çalışmaz.

  • Başvuruyu platform yöneticisi (OrqLabs'ı işleten taraf) bir kez yapar: GBP API iletişim formu → "Application for Basic API Access". Başvuru için en az 60 gündür doğrulanmış ve aktif bir işletme profili, profilde listelenen bir web sitesi ve profilde sahip/yönetici olan bir e-posta adresi gerekir (ön koşullar).
  • Onay gelene kadar entegrasyon bağlanır ama kartta "Google Business Profile API erişimi onaylanmamış" uyarısı görünür; yorum, gönderi ve performans işlemleri bu hatayla durur.
  • Onaydan sonra yeniden bağlamanız gerekmez: ayrıntı panelinde Listeyi yenile ile konumunuzu seçin.

Ön koşullar

  • business.google.com üzerinde doğrulanmış bir işletme profili ve bu profilde Sahip veya Yönetici rolü.
  • Platform tarafında: aynı Google OAuth istemcisi (GA4 / Search Console ile ortak: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET) ve onaylanmış API erişimi.

Adım adım kurulum

A) Google Cloud Console (platform yöneticisi)

  1. APIs & Services → Library → şu API'leri Enable edin: My Business Account Management API, My Business Business Information API, Google My Business API (yorumlar ve yerel gönderiler), Business Profile Performance API.
  2. Google Auth Platform → Data Access → kapsam ekleyin: https://www.googleapis.com/auth/business.manage.
  3. Clients → mevcut Web application istemcisi → Authorized redirect URIs listesine ekleyin: https://api.orqlabs.com/api/v1/integrations/oauth/google_business_profile/callback → Save.
  4. Erişim formunu gönderin ve onay e-postasını bekleyin. Projenin kota ekranında dakika başına istek (QPM) değeri 0 ise başvuru incelemededir; 300 görünüyorsa erişim açılmıştır.

B) OrqLabs'ta bağlama

Bağlantı penceresi (OAuth): ① proje seçimi, ② Bağla düğmesi.
Bağlantı penceresi (OAuth): ① proje seçimi, ② Bağla düğmesi.
  1. Entegrasyonlar → Google Business Profile → Bağla → ① Proje.
  2. ② Bağla → işletme profilini yöneten Google hesabını seçin → izni onaylayın.
  3. Geri dönüşte OrqLabs hesaplarınızı ve konumlarınızı listeler; ilk konum otomatik seçilir.
  4. Birden çok şubeniz varsa ayrıntı panelindeki İşletme konumu listesinden doğru şubeyi seçip Kaydet'e basın. Her şube için ayrı bağlantı (ve isterseniz ayrı proje) kullanın.
  5. Bağlantıyı test et: konumun adı görünür.

Yorum yanıtlama kuralları

YıldızNe olur?
4–5 ★Otomatik yanıt açıksa (autoReply) Topluluk Yöneticisi kısa bir teşekkür yanıtı yayınlar; kapalıysa yanıt Onaylar sayfasına düşer.
1–3 ★Asla otomatik yanıtlanmaz. Ajan veya iş akışı yanıt verse bile platform yanıtı durdurur, taslağı Onaylar sayfasına koyar ve size bildirim gönderir. Siz düzenleyip onayladığınızda yanıt Google'da yayınlanır.
  • Topluluk Yöneticisi düşük puanlı yorumları ayrıca Gelen Kutusuna insan desteği talebi olarak aktarır.
  • Ajan iade, tazminat veya hukuki kabul içeren cümleler kurmaz; bilgi bankasında olmayan söz vermez.
  • Yayınlanmış bir yanıtı değiştirmek için yeniden yanıt verin; Google aynı yanıtın üzerine yazar.

Yerel gönderiler

AlanKural
MetinEn fazla 1.500 karakter; hashtag ve telefon numarası kullanmayın
GörselBir fotoğraf (herkese açık https:// adresi)
DüğmeLEARN_MORE, BOOK, ORDER, SHOP, SIGN_UP (Bağlantı alanı gerekir) veya CALL (profildeki telefonu kullanır)
Etkinlik / KampanyaBaşlık + başlangıç + bitiş zorunlu; kampanyada kupon kodu ve kullanım bağlantısı eklenebilir

Gönderi yayınla kutusunda platform olarak Google Business Profile seçin; düğme ve etkinlik alanları kutunun ayarlarındadır. Hazır şablon: Google yorumlarına yanıt + haftalık işletme gönderisi.

İzinler ve kapsamlar

KapsamNeden gerekli
https://www.googleapis.com/auth/business.manageKonum listesi, yorum okuma/yanıtlama, yerel gönderi ve performans verisi

Sık karşılaşılan hatalar

HataOlası nedenÇözüm
CONFIG – "API erişimi onaylanmamış"Kota 0 veya API'ler etkin değilPlatform yöneticisi erişim formunu göndermeli ve dört API'yi etkinleştirmeli
FORBIDDEN – 403Google hesabınız bu konumda yönetici değilBusiness Profile'da rolünüzü kontrol edin, doğru hesapla yeniden yetkilendirin
AUTH – 401 / invalid_grantİzin iptal edildi veya süresi dolduYeniden yetkilendir
RATE_LIMIT – 429Dakika kotası aşıldıÇalışma sıklığını azaltın; otomatik yeniden denenir
Konum listesi boşProfil doğrulanmamış veya hesapta konum yokProfili doğrulayın; doğru Google hesabıyla bağlayın
Performans boşGoogle verisi birkaç gün gecikmeliBirkaç gün bekleyin; Şimdi senkronize et son 7 günü yeniden okur

Sonraki adım

OrqLabs ile başlayın

İlk iş akışınızı bugün kurun

Ücretsiz planla başlayın: hesaplarınızı bağlayın, bir şablon seçin, onay adımlarıyla kontrol sizde kalsın. Kredi kartı gerekmez.