نظرة عامة

تلخِّص هذه النظرة العامة عملية الطلب من البداية إلى النهاية وكيفية تفاعلها مع خدمة الويب الخاصة بتنفيذ الطلبات.

الترتيب

تعالج واجهة المستخدم لتجربة الطلب من البداية إلى النهاية جميع التفاعلات مع المستخدمين أثناء إضافة عناصر من القائمة إلى طلباتهم وتحديد ما إذا كانوا يريدون استلام الطلب أو توصيله، استنادًا إلى الخدمات التي يوفّرها المطعم. تستند هذه التجربة إلى عناصر Restaurant وService وMenu المتوفّرة في خلاصات البيانات.

الخطوة التالية هي مرحلة التحقّق من سلة التسوّق، حيث تعالج خدمة الويب Cart الناتجة عن العميل.

إجراء الدفع

إجراء الدفع هو أول طلب تُجريه Google إلى نقطة نهاية خدمة الويب. تتحمّل خدمة الويب مسؤولية التحقّق من صحة Cart. عليك تأكيد مدى توفّر السلع وأسعارها، وحساب الضرائب والتخفيضات والرسوم وإعادتها، والتحقّق من صحة عنوان تسليم الطلب.

تتّبع عملية الدفع التسلسل التالي:

1. تُرسِل خدمة "عملية الطلب الشاملة" CheckoutRequestMessage يحتوي على Cart إلى نقطة نهاية خدمة الويب الخاصة بتنفيذ الطلب.
2. يجب أن تتحقّق خدمة الويب من العناصر في Cart استنادًا إلى الأسعار الحالية ومدى التوفّر ومقدّمي الخدمات. بعد ذلك، يمكنك احتساب السعر الإجمالي الذي يشمل الخصومات والضرائب ورسوم التسليم.
3. تستجيب نقطة النهاية بـ CheckoutResponseMessage يحتوي على Cart غير معدَّل للطلبات الناجحة. يمكن تضمين FoodErrorExtension في CheckoutResponseMessage لعرض خطأ في المعالجة أو اقتراح تغييرات بسيطة، إذا لزم الأمر.

تحذير: لا تؤدي جميع طلبات إجراء الدفع إلى إنشاء طلب. لا تحافظ على الحالة استنادًا إلى طلبات إجراء الدفع.

بعد التحقّق من Cart، قد يختار المستخدم الانتقال إلى مرحلة إرسال الطلب في مسار المستخدم.

إجراء إرسال الطلب

يتم بدء إجراء إرسال الطلب عندما يقدّم المستخدم طلبه. على خدمة الويب إعادة التحقّق من سلة التسوّق ومعالجة رمز مفتاح البطاقة في حال كانت الدفعات على الإنترنت مفعَّلة، وأخيراً تعديل حالة الطلب.

تتّبع عملية إرسال الطلبات التسلسل التالي:

1. تُرسِل خدمة "عملية الطلب الشاملة" SubmitOrderRequestMessage يحتوي على Order إلى نقطة نهاية خدمة الويب الخاصة بتنفيذ الطلبات. يجب أن تُجري واجهة برمجة التطبيقات الخلفية عملية التحقّق من Cart مرة أخرى قبل المتابعة.

2. تعالج خدمة الويب تفاصيل الدفع المتوفّرة في Order، وعادةً ما تتّخذ الإجراءات التالية:

   1. التحقّق من الرموز المميّزة وعمليات الاحتيال والفحوصات الأخرى المتعلقة بالأهلية
   2. يمكنك تحصيل الرسوم من البطاقة أو تحصيل مبلغ مؤقتًا منها.

3. تستجيب نقطة النهاية برسالة SubmitOrderResponseMessage تحتوي على OrderUpdate بحالة CREATED ("تم الطلب" لعملية الشراء) CONFIRMED ("تم قبول" عملية الشراء) أو REJECTED ("تم رفض" عملية الشراء).

بعد تقديم الطلب، يتوقّع المستخدم تلقّي آخر المعلومات عن حالة الطلب من كلاً من أنت وواجهة مستخدم "عملية الطلب الشاملة". عليك إرسال رسالة تأكيد إلكترونية للمستخدم بشأن الطلب. بالإضافة إلى ذلك، يمكنك استخدام واجهة برمجة التطبيقات Asynchronous Order Update API لإرسال تعديلات الطلبات ذات الصلة إلى Google.

إجراء تعديل الطلب غير المتزامن

بغض النظر عن أي إشعارات مُرسَلة إلى المستخدمين من جانبك، عليك أيضًا إرسال تعديلات على حالة الطلب إلى Google عند حدوث الأحداث التالية:

1. التغييرات في OrderState مثل الانتقالات من CREATED إلى CONFIRMED وCONFIRMED إلى IN_TRANSIT
2. التغييرات في عناصر الطلب، مثل السعر أو مدى التوفّر
3. عندما يقدّم المستخدم طلب دعم من إحدى قنوات دعم العملاء

يتم إرسال التعديلات من نقطة نهاية خدمة الويب على شكل AsyncOrderUpdateRequestMessage يحتوي على OrderUpdate. تردّ Google برسالة AsyncOrderUpdateResponseMessage.

مخطّط التسلسل

يوضّح الرسم التوضيحي التالي كيفية تفاعل إجراءات التسليم مع خدمة الويب. انقر لتكبير الصورة.

إعداد نقطة نهاية التسليم

تستخدِم إجراءات "طلب الطعام" من البداية إلى النهاية رسائل JSON للتواصل مع خدمة الويب الخاصة بك ومعالجة طلبات الطعام وتأكيدها وتعديلها. عند تصميم خدمة الويب Ordering End-to-End، عليك تحديد نقطة نهاية لعنوان URL تتلقّى رسائل الطلبات من خدمة Ordering End-to-End ويمكنها إرسال الرسائل مرة أخرى إلى خدمة Google. يجب أن يستوفي التنفيذ المتطلّبات التالية:

• يجب أن تتمكّن خدمة الويب من تلقّي رسالة JSON كطلب POST من خدمة "الطلب من البداية إلى النهاية".
• يجب أن تقدّم خدمة الويب نقطة نهاية عنوان URL متاحة للجميع، تُعرف باسم عنوان URL للتسليم، والذي تحدّده في "مركز الإجراءات". يُستخدَم عنوان URL الخاص بمركز التوزيع لدفع رسوم الطلبات وإرسالها. يجب أن يعالج عملية التنفيذ كلا النوعَين من الطلبات.
• يجب أن تكون خدمة الويب قادرة على إثبات صحة الرسائل الواردة من Google باستخدام طريقة إثبات صحة الرسائل.
• يجب أن يكون تنفيذك لنقطة نهاية عنوان URL قادرًا على معالجة كل من عملية الدفع وتسليم الطلبات باستخدام نقطة نهاية واحدة. لا يمكنك استخدام نقطة نهاية واحدة لعنوان URL لدفع ونقطة نهاية منفصلة لإرسال الطلبات.

مكتبات العملاء

يتوفّر أداة إنشاء رموز العملاء في قسم "الأدوات" للتحقّق من صحة خدمة الويب وفقًا لملف مواصفات Fulfillment API.