واجهة برمجة روابط مراجعات Google

المدخلات المدعومة

• رابط 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)
  افتح الرابط القصير وأرسل رابط Maps النهائي الكامل.
• upstream_timeout (504)
  انتظر وحاول مرة واحدة أو أرسل رابط Maps النهائي الكامل.

حدود الاستخدام

الحد المجهول هو نحو 20 طلبًا في الدقيقة لكل عنوان IP. يتشارك الوكلاء الذين يستخدمون العنوان نفسه هذا الحد.

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

قد لا تتضمن استجابة 429 الصادرة من الحافة JSON أو Retry-After. انتظر 60 ثانية على الأقل ثم زد مدة الانتظار.

اعثر على رابط Maps الصحيح

1. افتح الموقع الدقيق للنشاط في Google Maps.
2. تحقق من الفرع والعنوان ثم اختر مشاركة.
3. انسخ الرابط وأرسله في maps_url.

استخدام البيانات

تسجّل الطلبات الناجحة معرّف المكان واللغة والوقت والموقع التقريبي للنشاط التجاري عند توفره. تُخزّن الروابط القصيرة بعد حلّها مؤقتًا لمدة 24 ساعة.