API başvuru kaynağı

Google yorum bağlantısı API’si

Bir Google Maps URL'sini doğrudan yorum bağlantısına dönüştürün. Kayıt veya Google API anahtarı gerekmez.

  1. İstek

    application/json { "maps_url": "https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2" }
  2. POST /api/v1/google-review-link productmate.com

  3. Yanıt 200

    application/json { "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY", "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY", "verification": "not_verified" }
POST/api/v1/google-review-link

Desteklenen giriş

  • Belirli bir yer için tam Google Maps URL'si
  • maps.app.goo.gl paylaşım bağlantısı
  • Eski bir goo.gl/maps paylaşım bağlantısı

İstek

Uç noktaya tek bir JSON nesnesi gönderin. İşletme adları ve tek başına Place ID kabul edilmez.

curl -X POST https://productmate.com/api/v1/google-review-link \
  -H "Content-Type: application/json" \
  -d '{"maps_url":"https://www.google.com/maps/place/PRODUCTMATE/data=!1s0x47b18f1cae867bab:0xb6f8b3a3753ba1a2!8m2"}'

Yanıt

{
  "place_id": "ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "review_url": "https://search.google.com/local/writereview?placeid=ChIJq3uGrhyPsUcRoqE7daOz-LY",
  "verification": "not_verified"
}

verification her zaman not_verified değerindedir. Bağlantıyı vermeden önce konumu kontrol edin.

Hatalar ve çözüm

  • invalid_request (400)
    Boş olmayan bir maps_url içeren geçerli JSON gönderin.
  • unsupported_url (422)
    Google Maps'teki belirli bir işletmenin Paylaş bağlantısını kullanın.
  • unsafe_redirect (422)
    Yalnızca Google Maps'e yönlendiren bir bağlantı kullanın.
  • upstream_unresolved (502)
    Kısa bağlantıyı açın ve son tam Maps URL'sini gönderin.
  • upstream_timeout (504)
    Bekleyin, bir kez daha deneyin veya son tam Maps URL'sini gönderin.

Kullanım sınırları

Anonim sınır, istemci IP'si başına dakikada yaklaşık 20 istektir. Aynı IP'yi kullanan aracılar bu sınırı paylaşır.

Content-Length: 16 KiB
maps_url: 8 KiB
short_url_resolution_deadline: 10 s

Uçta üretilen 429 yanıtında JSON veya Retry-After olmayabilir. En az 60 saniye bekleyin, sonra bekleme süresini artırın.

Doğru Maps URL'sini bulun

  1. Google Maps'te işletmenin tam konumunu açın.
  2. Şube adı ve adresi kontrol edin, sonra Paylaş'ı seçin.
  3. Bağlantıyı kopyalayıp maps_url olarak gönderin.

Veri kullanımı

Başarılı çağrılar yer tanımlayıcısını, dili, zamanı ve mevcutsa işletmenin yaklaşık konumunu kaydeder. Çözümlenen kısa URL’ler 24 saat önbellekte tutulur.