Dokumentacja API

API linków do opinii Google

Zamień jeden adres Google Maps na bezpośredni link do opinii. Rejestracja i klucz API Google nie są wymagane.

  1. Żądanie

    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. Odpowiedź 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

Obsługiwane dane

  • Pełny adres Google Maps konkretnego miejsca
  • Link udostępniania maps.app.goo.gl
  • Starszy link goo.gl/maps

Żądanie

Wyślij jeden obiekt JSON do punktu końcowego. Nazwy firm i same Place ID nie są przyjmowane.

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

Odpowiedź

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

verification ma zawsze wartość not_verified. Sprawdź lokalizację przed przekazaniem linku.

Błędy i rozwiązania

  • invalid_request (400)
    Wyślij poprawny JSON z niepustym maps_url.
  • unsupported_url (422)
    Użyj linku Udostępnij konkretnej firmy w Google Maps.
  • unsafe_redirect (422)
    Użyj linku, który przekierowuje wyłącznie do Google Maps.
  • upstream_unresolved (502)
    Otwórz krótki link i wyślij jego pełny końcowy adres Maps.
  • upstream_timeout (504)
    Poczekaj, spróbuj raz ponownie lub wyślij pełny końcowy adres Maps.

Limity użycia

Anonimowy limit wynosi około 20 żądań na minutę dla jednego adresu IP. Agenci korzystający ze wspólnego IP dzielą ten limit.

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

Odpowiedź 429 z warstwy brzegowej może nie zawierać JSON ani nagłówka Retry-After. Poczekaj co najmniej 60 sekund, a potem zwiększaj czas oczekiwania.

Znajdź właściwy adres Maps

  1. Otwórz dokładną lokalizację firmy w Google Maps.
  2. Sprawdź oddział i adres, a następnie wybierz Udostępnij.
  3. Skopiuj link i wyślij go jako maps_url.

Wykorzystanie danych

Udane wywołania zapisują identyfikator miejsca, język, czas i przybliżoną lokalizację firmy, jeśli jest dostępna. Rozwinięte krótkie adresy URL są przechowywane w pamięci podręcznej przez 24 godziny.