يستعرض هذا البرنامج التعليمي:
- وصف عالي المستوى لطريقة عرض مدى التوفّر للمستخدم ونوع البيانات المطلوبة
- تعليمات محدّدة حول كيفية ترميز بيانات مدى التوفّر في
action_linkفي خلاصاتك - تعليمات حول كيفية تعديل مدى التوفّر إذا تغيّر على مدار اليوم
- توقّعات دقة مدى التوفّر
بالإضافة إلى البيانات الوصفية لمدى التوفّر، من المتوقّع أيضًا أن تقدّم بيانات وصفية عن الرسوم المرتبطة بالتسليم أو الاستلام، بالإضافة إلى الحد الأدنى من مبالغ الطلبات. للحصول على نموذج خلاصة كامل يعرض استخدام مدى التوفّر بالإضافة إلى الرسوم والحد الأدنى من الطلبات، يُرجى الاطّلاع على نموذج خلاصة طلب البيع بالتجزئة 1.
معلومات التوفر المطلوبة
يتم جمع بيانات مدى توفّر طلبات البيع بالتجزئة لهذه التجربة بدقة على مستوى اليوم. يتم عرض بيانات مدى التوفّر هذه للمستخدمين بالإضافة إلى الرسوم ومبالغ الطلبات الدنيا مع رسالة مثل "متاح اليوم" أو "متاح غدًا" أو "DD/MM متاح" استنادًا إلى أقرب تاريخ متاح.
عند إرسال هذه البيانات في الخلاصات، سترسِل في المستقبل تواريخ توفّر فضلاً عن آخر مرة يمكن فيها للمستخدم تقديم طلب لتحديد موعد للاستلام أو التوصيل في كل تاريخ. هذان المعلومةان هما تاريخ تسليم الطلب وآخر وقت طلب على التوالي.
على سبيل المثال: إذا كان تاريخ اليوم هو 23 آذار (مارس) 2021، وكان هناك مدى توفّر للتسليم غدًا طالما أنّ المستخدم يقدّم الطلب بحلول اليوم 4:00 مساءً، حينئذٍ تكون البيانات التي ستقدّمها لتمثيل مدى التوفّر هي:
- تاريخ الوفاء: 2021/03/24
- وقت آخر طلب: 23/03/2021 4:00 مساءً
ونظرًا إلى تضمين وقت آخر طلب، بعد مرور هذا الوقت، سيتم تعديل "واجهة Google الأمامية" تلقائيًا إلى التاريخ المتاح التالي، بعد مرور آخر وقت للطلب.
ويجب تضمين بيانات مدى التوفّر الجديدة كل يوم عند تحميل خلاصة تاجر جديدة. بما أنّ الواجهة الأمامية تعرض مدى التوفّر الحالي فقط، من الضروري تقديم التواريخ التالية التي تتراوح بين 3 و5 تواريخ محدّدة لأي موقع جغرافي. ويتيح ذلك للواجهة الأمامية عرض مدى التوفّر الحالي بالإضافة إلى عرض مدى التوفّر التالي بعد مرور آخر وقت للطلب.
تحديد مدى التوفر من خلال الخلاصات
ويتم إدراج مدى توفّر روابط الإجراءات في رسالة action_link الخاصة بخلاصة التاجر
كجزء من الحقل order_online_metadata. بالنسبة إلى كل تاجر وكل خيار من خيارات توصيل الطلبات، تتوفّر قائمة برسائل AvailableDay في المسار
Merchant.action_link.order_online_metadata.fulfillment_option.available_day
يجب أن تكون هذه الرسائل بالتنسيق التالي:
{
"fulfillment_date": {
"year": "2020",
"month": "10",
"day": "1"
},
"last_ordering_time": {
"seconds": "1601614800" // 2020/10/1, 10pm
}
}
بهذا التنسيق، يكون fulfillment_date هو العام والشهر واليوم الذي يتوفّر فيه العرض. ويجب أن يكون هذا التاريخ في إشارة إلى الموقع الجغرافي الذي حدّده هذا التاجر.
last_ordering_time هو طابع زمني لنظام التشغيل Unix. وهذه العملية تختلف عن المنطقة الزمنية وتشير إلى اللحظة الأخيرة التي يمكن للتاجر تلقّي الطلبات فيها في التاريخ المقدّم في fulfillment_date. ويمكن أن يكون وقت الطلب الأخير في أي وقت قبل تاريخ توصيل الطلب أو أثناءه. وبعد مرور آخر وقت لتقديم الطلب، ستتوقف Google تلقائيًا عن عرض مدى توفّر الطلبات في التاريخ المحدّد لتوصيل الطلبات، وستبدأ في إظهار مدى التوفّر استنادًا إلى تاريخ التنفيذ التالي المتاح.
للحصول على تعريف مرجع order_online_metadata، يمكنك الاطّلاع على
مرجع خلاصة التاجر. وللاطّلاع على عيّنة من الخلاصة تتضمّن مدى التوفّر
بتنسيق JSON، يمكنك مراجعة
نماذج عن خلاصات البيع بالتجزئة بالإضافة إلى البيانات الوصفية.
تحديث مدى التوفّر من خلال تعديلات في الوقت الفعلي
إذا تغيّر مدى توفّر الموقع الجغرافي للتسليم أو الاستلام في الفترة التي تُرسِل فيها خلاصة يومية، يمكن استخدام واجهة برمجة تطبيقات REST التي يتم تحديثها في الوقت الفعلي لتعديل معلومات مدى التوفّر التي تظهر للمستخدمين.
يتم إجراء التعديلات على تاجر واحد في كل مرة. عند إجراء تعديل، عليك تحديد التاجر الذي تريد تعديل معلوماته، والحقول التي يجب تعديلها كجزء من نقطة نهاية واجهة برمجة التطبيقات. بعد ذلك، عليك تضمين البيانات الجديدة لتلك الحقول في نص الطلب. سيتم استبدال أي حقول يتم تحديثها بالمعلومات المقدّمة.
لتعديل مدى التوفّر، عليك إرسال طلب تصحيح إلى نقطة النهاية التالية:
PATCH https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/{merchantId}?updateMask=action_link
سيكون نص الطلب عبارة عن كائن التاجر مع تضمين action_link فقط (بما أنّنا قد حدّثنا updateMask بحيث يتضمّن action_link فقط):
{
"action_link": [
..., // all required action_link fields here
"order_online_metadata": {
"fulfillment_option": [
"fulfillment_type": "FULFILLMENT_TYPE_DELIVERY",
"available_day": [ // Include the updated availability here
{
"fulfillment_date": {
"year": "2020",
"month": "10",
"day": "1"
}
"last_ordering_time": {
"seconds": "1601614800" // 2020/10/1, 10pm
}
},
... // Other updated availability_days
]
]
}
]
}
إذا نجح طلب واجهة برمجة التطبيقات، ستتضمن الاستجابة كائن التاجر بالبيانات التي تم تعديلها مؤخرًا.
للحصول على مواصفات مرجعية كاملة لطريقة تعديل التاجر، يُرجى الاطّلاع على: الطريقة: مستودع.partners.merchants.patch.
دقة مدى التوفّر
تدرك شركة "الحجز عبر Google" أنّ تفاصيل مدى التوفّر تتغيّر استنادًا إلى مجموعة متنوعة من العوامل. وتشمل هذه العوامل ما يلي:
- تغييرات مدى التوفر استنادًا إلى حجم الطلب
- التغييرات على مدى توفّر المنتج استنادًا إلى الوقت المطلوب لإتمام الطلب والدفع
- وقت الاستجابة بين وقت تعديل تغييرات مدى التوفّر، إما من خلال الخلاصات أو من خلال تعديلات في الوقت الفعلي
وقد يؤدي أي من هذه العوامل إلى حالات لا يكون فيها مدى التوفّر المعروض للمستخدم في البداية هو السعر النهائي الذي سيراه عند الدفع. ولا يكمن الهدف من تطبيق مدى التوفّر في القضاء تمامًا على هذه المتطلبات، بل توفير معلومات واضحة للمستخدمين قدر الإمكان.
ومن المتوقع أن يوفّر الشركاء طريقة تنفيذ تؤدي إلى عرض مدى التوفّر الدقيق للمستخدمين لأكبر عدد ممكن من المرات، على أساس أفضل الجهود. بالإضافة إلى ذلك، إذا تغيّر مدى التوفّر بسبب تفاصيل الطلب، يجب أن يظهر هذا التغيير بوضوح للمستخدمين. إذا لم تكن متأكدًا مما هو مطلوب في حالتك تحديدًا، يُرجى التواصل مع جهة اتصال "الحجز عبر Google".