Αναφορά 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 στο endpoint. Ονόματα επιχειρήσεων και μεμονωμένα 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 ώρες.