دليل لوكلاء الذكاء الاصطناعي

واجهة روابط تقييمات Google لوكلاء الذكاء الاصطناعي

حوّل رابط 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

اعثر على رابط 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"}'

الاستجابة

تكون verification دائمًا not_verified. تحقق من الموقع قبل تسليم الرابط.

مرجع واجهة البرمجة →

الأخطاء والاسترداد

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

الأخطاء والاسترداد →

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

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