Google İşletme Profili API: Ne Yapar, Ne Yapmaz

Google İşletme Profili API'si, profil verisini program aracılığıyla okumayı ve yazmayı sağlıyor. Birden çok lokasyon yöneten ajanslar ve araçlar için tek gerçekçi yol bu.

Ama API'nin yapmadığı bir şey var ve bu yazının asıl konusu o.

API ile ne yapılabilir

Okuma: lokasyon bilgileri, kategoriler, çalışma saatleri, öznitelikler, yorumlar, gönderiler, medya ve profil istatistikleri (görüntülenme, arama, yol tarifi talebi).

Yazma: lokasyon bilgisi güncelleme, gönderi oluşturma ve zamanlama, yoruma cevap yazma, fotoğraf yükleme, çalışma saati değiştirme.

Toplu işlem: çok sayıda lokasyonda aynı değişikliği tek seferde uygulamak. Yüz şubeli bir markanın bayram saatlerini elle girmesiyle API ile girmesi arasındaki fark, günlerle dakikalar arasındaki fark.

API ile ne yapılamaz

Sıralama verisi alınamaz. API bir işletmenin harita sonuçlarında kaçıncı sırada olduğunu söylemiyor ve söylemeyecek. Sebebi teknik değil, mantıksal: tek bir sıralama yok. Harita sonuçları arayan kişinin konumuna göre değişiyor; "senin sıran şu" diye bir sayı üretmek için önce "nereden bakıldığında" sorusunun cevaplanması gerekiyor.

Sıralama ancak ölçülerek bulunuyor: bölgeyi ızgaraya bölüp her noktadan arama yaparak. Bu veri API'den gelmiyor, arama sonuçlarından toplanıyor.

Rakip verisi alınamaz. API yalnızca senin yönettiğin profilleri gösteriyor.

Erişim nasıl alınır

Google Cloud Console'da proje açılıyor, ilgili API'ler etkinleştiriliyor, OAuth yapılandırılıyor. Sonra Google'a kota başvurusu yapılıyor — ve bu adım anında sonuçlanmıyor. Başvuru formunda aracın ne yaptığı, kaç lokasyon yöneteceği ve veriyi nasıl kullanacağı soruluyor.

Onay süresi değişken. Başvuru reddedilirse sebebi bildiriliyor ve düzeltip tekrar başvurulabiliyor.

Kendi aracını yazacaksan dikkat edilecekler

Kota. Günlük istek sınırı var ve lokasyon sayısına göre ölçekleniyor. Toplu işlem yaparken sınıra çarpmak yaygın.

Yorum cevaplama izni. Hesabın profil üzerinde gerçekten yetkili olması gerekiyor; sahiplik devri tamamlanmadan API yazma izni çalışmıyor.

Veri tazeliği. API'den gelen istatistikler gerçek zamanlı değil; birkaç günlük gecikme normal.

Pratik sonuç

İki ayrı iş var ve ikisi iki farklı kaynaktan geliyor:

• Profili yönetmek — API'nin işi. Toplu düzenleme, gönderi, yorum cevabı.
• Nerede göründüğünü bilmek — ölçümün işi. Izgara taraması, nokta nokta.

Birini diğerinin yerine koymaya çalışmak, bu konuda yapılan en yaygın yanlış. Bir araç "API'den sıralama veriyoruz" diyorsa, ya ölçüm yapıyordur ya da söylediği şey doğru değildir.