API dokumentacija

API za poveznice na Google recenzije

Pretvorite jedan URL Google Mapsa u izravnu poveznicu za recenziju. Registracija i Google API ključ nisu potrebni.

  1. Zahtjev

    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. Odgovor 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

Podržani unos

  • Potpuni URL Google Mapsa za određeno mjesto
  • Poveznica za dijeljenje maps.app.goo.gl
  • Starija poveznica goo.gl/maps

Zahtjev

Pošaljite jedan JSON objekt krajnjoj točki. Nazivi tvrtki i samostalni Place ID nisu prihvaćeni.

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

Odgovor

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

verification je uvijek not_verified. Provjerite lokaciju prije nego što predate poveznicu.

Pogreške i oporavak

  • invalid_request (400)
    Pošaljite valjani JSON s nepraznim maps_url.
  • unsupported_url (422)
    Upotrijebite poveznicu Dijeli određene tvrtke u Google Mapsu.
  • unsafe_redirect (422)
    Upotrijebite poveznicu koja preusmjerava samo na Google Maps.
  • upstream_unresolved (502)
    Otvorite kratku poveznicu i pošaljite njezin završni puni URL Mapsa.
  • upstream_timeout (504)
    Pričekajte, pokušajte još jednom ili pošaljite završni puni URL Mapsa.

Ograničenja upotrebe

Anonimno ograničenje iznosi približno 20 zahtjeva u minuti po IP adresi. Agenti sa zajedničkom IP adresom dijele ograničenje.

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

Odgovor 429 s mrežnog ruba možda nema JSON ni Retry-After. Pričekajte najmanje 60 sekundi i zatim povećavajte čekanje.

Pronađite točan URL Mapsa

  1. Otvorite točnu lokaciju tvrtke u Google Mapsu.
  2. Provjerite poslovnicu i adresu te odaberite Dijeli.
  3. Kopirajte poveznicu i pošaljite je kao maps_url.

Upotreba podataka

Uspješni pozivi bilježe identifikator mjesta, jezik, vrijeme i približnu lokaciju poslovnog objekta, ako je dostupna. Razriješeni kratki URL-ovi pohranjuju se u predmemoriju na 24 sata.