Rujukan API

API pautan ulasan Google

Tukar satu URL Google Maps kepada pautan ulasan terus. Pendaftaran dan kunci Google API tidak diperlukan.

  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 disokong

  • URL Google Maps penuh untuk tempat tertentu
  • Pautan Kongsi maps.app.goo.gl
  • Pautan lama goo.gl/maps

Permintaan

Hantar satu objek JSON ke titik akhir. Nama perniagaan dan Place ID sahaja 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 sentiasa not_verified. Semak lokasi sebelum memberikan pautan.

Ralat dan pemulihan

  • invalid_request (400)
    Hantar JSON yang sah dengan maps_url yang tidak kosong.
  • unsupported_url (422)
    Gunakan pautan Kongsi perniagaan tertentu dalam Google Maps.
  • unsafe_redirect (422)
    Gunakan pautan yang hanya menghala ke Google Maps.
  • upstream_unresolved (502)
    Buka pautan pendek dan hantar URL Maps penuh akhirnya.
  • upstream_timeout (504)
    Tunggu, cuba sekali lagi atau hantar URL Maps penuh akhirnya.

Had penggunaan

Had tanpa nama ialah kira-kira 20 permintaan seminit bagi setiap IP klien. Ejen dengan IP yang sama berkongsi had ini.

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

Respons 429 daripada pinggir rangkaian mungkin tiada JSON atau Retry-After. Tunggu sekurang-kurangnya 60 saat, kemudian tambah tempoh menunggu.

Cari URL Maps yang betul

  1. Buka lokasi perniagaan yang tepat dalam Google Maps.
  2. Semak cawangan dan alamat, kemudian pilih Kongsi.
  3. Salin pautan dan hantar sebagai maps_url.

Penggunaan data

Panggilan yang berjaya merekodkan pengecam tempat, bahasa, masa dan anggaran lokasi perniagaan jika tersedia. URL pendek yang telah dileraikan disimpan dalam cache selama 24 jam.