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

حوّل رابط Google Maps واحدًا إلى رابط مباشر للتقييم. لا يلزم التسجيل أو مفتاح Google API.

تحقق من الموقع أولًا
تستخرج الواجهة معرّفًا وتنشئ رابطًا. وهي لا تؤكد اسم النشاط أو عنوانه أو توفر التقييمات.

المدخلات المدعومة
1. رابط Google Maps كامل لمكان محدد
2. رابط مشاركة maps.app.goo.gl
3. رابط مشاركة قديم goo.gl/maps

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

الطلب
أرسل كائن 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 ثانية على الأقل ثم زد مدة الانتظار.

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

مجموعة Postman: https://productmate.com/developers/google-review-link/postman.json

OpenAPI: https://productmate.com/developers/google-review-link/openapi.json

مرجع واجهة البرمجة: https://productmate.com/ar/developers/google-review-link

دليل لوكلاء الذكاء الاصطناعي: https://productmate.com/ar/agents/google-review-link

فتح منشئ رابط التقييم: https://productmate.com/ar/munshi-rabit-taqyimat-google