Довідник API

API посилань на відгуки Google

Перетворіть одну URL-адресу Google Maps на пряме посилання для відгуку. Реєстрація та ключ Google API не потрібні.

  1. Запит

    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. Відповідь 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

Підтримувані дані

  • Повна URL Google Maps для конкретного місця
  • Посилання для поширення maps.app.goo.gl
  • Старе посилання goo.gl/maps

Запит

Надішліть один об’єкт JSON до кінцевої точки. Назви компаній і окремі Place ID не приймаються.

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

Відповідь

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

verification завжди має значення not_verified. Перевірте місце, перш ніж передати посилання.

Помилки та відновлення

  • invalid_request (400)
    Надішліть дійсний JSON із непорожнім maps_url.
  • unsupported_url (422)
    Використайте посилання Поділитися для конкретної компанії в Google Maps.
  • unsafe_redirect (422)
    Використайте посилання, що переспрямовує лише до Google Maps.
  • upstream_unresolved (502)
    Відкрийте коротке посилання й надішліть повну кінцеву URL Maps.
  • upstream_timeout (504)
    Зачекайте, повторіть один раз або надішліть повну кінцеву URL Maps.

Обмеження використання

Анонімний ліміт становить приблизно 20 запитів на хвилину для кожної IP-адреси. Агенти зі спільною IP-адресою ділять цей ліміт.

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

Відповідь 429 від периферійного вузла може не містити JSON або Retry-After. Зачекайте щонайменше 60 секунд і надалі збільшуйте затримку.

Знайдіть правильну URL Maps

  1. Відкрийте точне місце компанії в Google Maps.
  2. Перевірте філію й адресу та виберіть Поділитися.
  3. Скопіюйте посилання й надішліть його як maps_url.

Використання даних

Успішні виклики записують ідентифікатор місця, мову, час і приблизне розташування закладу, якщо воно доступне. Розгорнуті короткі URL кешуються на 24 години.