API-dokumentáció

Google-véleménylink API

Alakítson át egy Google Maps URL-t közvetlen értékelési linkké. Nem kell regisztráció vagy Google API-kulcs.

  1. Kérés

    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. Válasz 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

Támogatott bemenet

  • Egy adott hely teljes Google Maps URL-je
  • maps.app.goo.gl megosztási link
  • Régi goo.gl/maps megosztási link

Kérés

Küldjön egy JSON objektumot a végpontnak. Cégnevek és önálló Place ID-k nem használhatók.

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

Válasz

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

A verification értéke mindig not_verified. Ellenőrizze a helyet, mielőtt átadja a linket.

Hibák és megoldások

  • invalid_request (400)
    Küldjön érvényes JSON-t nem üres maps_url értékkel.
  • unsupported_url (422)
    Használja egy adott Google Maps-cég Megosztás linkjét.
  • unsafe_redirect (422)
    Olyan linket használjon, amely csak a Google Mapsre irányít.
  • upstream_unresolved (502)
    Nyissa meg a rövid linket, és küldje el a végső teljes Maps URL-t.
  • upstream_timeout (504)
    Várjon, próbálja újra egyszer, vagy küldje el a végső teljes Maps URL-t.

Használati korlátok

A névtelen korlát ügyfél-IP-nként körülbelül 20 kérés percenként. A közös IP-t használó ügynökök osztoznak a kereten.

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

A peremhálózaton létrehozott 429 válaszban lehet, hogy nincs JSON vagy Retry-After. Várjon legalább 60 másodpercet, majd növelje a várakozási időt.

A megfelelő Maps URL megkeresése

  1. Nyissa meg a pontos üzleti helyet a Google Mapsben.
  2. Ellenőrizze a telephelyet és a címet, majd válassza a Megosztás lehetőséget.
  3. Másolja a linket, és küldje el maps_url értékként.

Adatfelhasználás

A sikeres hívások rögzítik a hely azonosítóját, a nyelvet, az időpontot és az üzlet hozzávetőleges helyét, ha elérhető. A feloldott rövid URL-eket 24 órán át gyorsítótárazzuk.