Dokumentace API

API odkazů na recenze Google

Převeďte jednu URL Google Maps na přímý odkaz pro recenzi. Registrace ani klíč Google API nejsou nutné.

  1. Požadavek

    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. Odpověď 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

Podporovaný vstup

  • Úplná URL Google Maps pro konkrétní místo
  • Odkaz pro sdílení maps.app.goo.gl
  • Starší odkaz goo.gl/maps

Požadavek

Pošlete na koncový bod jeden objekt JSON. Názvy firem a samostatná Place ID nejsou přijímány.

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"}'

Odpověď

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

verification je vždy not_verified. Před předáním odkazu ověřte místo.

Chyby a řešení

  • invalid_request (400)
    Pošlete platný JSON s neprázdným maps_url.
  • unsupported_url (422)
    Použijte odkaz Sdílet konkrétní firmy v Google Maps.
  • unsafe_redirect (422)
    Použijte odkaz, který přesměruje pouze na Google Maps.
  • upstream_unresolved (502)
    Otevřete krátký odkaz a pošlete jeho úplnou cílovou URL Maps.
  • upstream_timeout (504)
    Počkejte, zkuste to jednou znovu nebo pošlete úplnou cílovou URL Maps.

Limity použití

Anonymní limit je přibližně 20 požadavků za minutu na jednu IP adresu. Agenti se sdílenou IP tento limit sdílejí.

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

Odpověď 429 vytvořená na okraji sítě nemusí obsahovat JSON ani Retry-After. Počkejte nejméně 60 sekund a další prodlevy prodlužujte.

Najděte správnou URL Maps

  1. Otevřete přesné místo firmy v Google Maps.
  2. Zkontrolujte pobočku a adresu a vyberte Sdílet.
  3. Zkopírujte odkaz a odešlete jej jako maps_url.

Použití dat

Úspěšná volání ukládají identifikátor místa, jazyk, čas a přibližnou polohu podniku, pokud je dostupná. Rozbalené krátké URL se ukládají do mezipaměti na 24 hodin.