Referensi API

API tautan ulasan Google

Ubah satu URL Google Maps menjadi tautan ulasan langsung. Tidak perlu mendaftar atau memakai kunci Google API.

  1. Permintaan

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

Input yang didukung

  • URL Google Maps lengkap untuk tempat tertentu
  • Tautan Bagikan maps.app.goo.gl
  • Tautan lama goo.gl/maps

Permintaan

Kirim satu objek JSON ke endpoint. Nama bisnis dan Place ID tanpa URL tidak diterima.

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

Respons

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

verification selalu bernilai not_verified. Periksa lokasi sebelum memberikan tautan.

Kesalahan dan pemulihan

  • invalid_request (400)
    Kirim JSON valid dengan maps_url yang tidak kosong.
  • unsupported_url (422)
    Gunakan tautan Bagikan dari bisnis tertentu di Google Maps.
  • unsafe_redirect (422)
    Gunakan tautan yang hanya mengarahkan ke Google Maps.
  • upstream_unresolved (502)
    Buka tautan pendek dan kirim URL Maps lengkap akhirnya.
  • upstream_timeout (504)
    Tunggu, coba sekali lagi, atau kirim URL Maps lengkap akhirnya.

Batas penggunaan

Batas anonim sekitar 20 permintaan per menit untuk setiap IP klien. Agen dengan IP bersama menggunakan batas yang sama.

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

Respons 429 dari edge mungkin tidak memiliki JSON atau Retry-After. Tunggu setidaknya 60 detik, lalu tambah jeda pada percobaan berikutnya.

Temukan URL Maps yang benar

  1. Buka lokasi bisnis yang tepat di Google Maps.
  2. Periksa cabang dan alamat, lalu pilih Bagikan.
  3. Salin tautan dan kirim sebagai maps_url.

Penggunaan data

Panggilan yang berhasil mencatat pengenal tempat, bahasa, waktu, dan perkiraan lokasi bisnis jika tersedia. URL pendek yang telah diurai disimpan dalam cache selama 24 jam.