Przewodnik dla agentów AI

API linków do opinii Google dla agentów AI

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

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.

Jeśli oddział jest niejasny, poproś użytkownika o dokładną lokalizację. Nie zgaduj ani nie twierdź, że wynik został zweryfikowany.

Żą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ź

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

Dokumentacja API →

Błędy i rozwiązania

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.

Błędy i rozwiązania →

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.