واجهة برمجة التطبيقات Test Fulfillment

بعد تنفيذ Checkout وOrder submit لواجهة برمجة التطبيقات Ordering End-to-End fulfillment API، اختبِر معالِج الطلبات للتأكّد من عمل كلتا المخطّطَين.

المتطلبات الأساسية

للاستعداد لاختبار واجهة برمجة التطبيقات لميزة Fulfillment، اتّبِع الخطوات التالية:

• تأكَّد من أنّ لديك إذن الوصول للتعديل إلى مشروع Google Cloud Platform المرتبط بحسابك على Ordering End-to-End في مركز الإجراءات. يمكنك التحقّق من إمكانية الوصول إلى المشروع وتعديلها باستخدام وحدة تحكّم إدارة الهوية وإمكانية الوصول (IAM) في Cloud Identity من Google.

• حمِّل ملفًا بتنسيق JSON لخلاصة البيانات لاستخدامه في الاختبار. يجب أن تحتوي خلاصة البيانات على كيان Restaurant واحد على الأقل والكيانَين Service و Menu المرتبطَين به. يمكنك استخدام إحدى خلاصات البيانات الصالحة التي سبق أن أنشأتها في القسم طلب خلاصات البيانات من البداية إلى النهاية.

• عدِّل Fulfillment API باستخدام رمز إجراءات Checkout و Order submit التي نفّذتها.

• تأكَّد من أنّ نقطة نهاية عنوان URL الخاص بتنفيذ الطلبات متاحة للجميع.

الاختبار

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

ملاحظة: بعد إكمال اختبارات إرسال الطلبات بنجاح، احرص على اختبار سرعة الاستجابة. يجب أن تستجيب نقطة النهاية في غضون 8 ثوانٍ لتوفير تجربة مستخدم مثالية.

الاختبار باستخدام أداة الاختبار المبرمَج

يوفّر مركز الإجراءات مجموعة من الاختبارات المبرمَجة التي يمكنك إجراؤها على نقطة نهاية التسليم لاختبار الدفع والإرسال. يمكن أن توفّر لك طريقة الاختبار هذه الوقت من خلال التشغيل الآلي لعملية الاختبار وتوفير مجموعة اختبارات repeatable.

ملاحظة: لا تتيح أداة اختبار الدمج اختبار عملية إرسال الطلبات إلا باستخدام Stripe وBraintree والدفع نقدًا عند الاستلام. إذا لم تتمكّن من استخدام أحد خيارات الاختبار هذه، استخدِم طريقة الاختبار اليدوي.

لاختبار معالجَي الدفع وإرسال الطلبات في واجهة برمجة التطبيقات الخاصة بميزة الوفاء، اتّبِع الخطوات التالية:

1. تأكَّد من اختيار البيئة المناسبة من أداة اختيار البيئة.
2. انتقِل إلى المستودع > اختبار الدمج في مركز الإجراءات.
3. انقر على اختبار جديد.
4. في حقل نقطة نهاية التسليم، أدخِل عنوان URL لنقطة نهاية التسليم الذي تريد اختباره.
5. في قسم حالات الاختبار ضمن القائمة المنسدلة الدفع، اختَر حالات الاختبار التي تريد تنفيذها. ننصحك بالبدء بـ سلة التسوّق المؤهّلة - السلع بدون خيارات.
6. في قسم حالات الاختبار ضمن القائمة المنسدلة إرسال الطلب، اختَر حالات الاختبار التي تريد تنفيذها باستخدام معالِج إرسال الطلب. ننصحك ببدء الاختبار باستخدام حالة سلة التسوّق المؤهَّلة.
7. يمكنك أيضًا تعديل مَعلمتَي "عيّنات" و"عدد الطلبات في الثانية":
   • عيّنات: عدد عناصر المطاعم التي يتم اختيارها عشوائيًا للاختبار
   • عدد الطلبات في الثانية: الحدّ الأقصى لعدد الطلبات في الثانية الذي يمكن أن تتعامل معه واجهة برمجة التطبيقات للخدمة.
8. لبدء الاختبار، انقر على تنفيذ.

انتظِر حتى اكتمال الاختبار. قد تستغرق هذه العملية مدة تصل إلى 20 دقيقة استنادًا إلى عدد الكيانات وحالات الاختبار التي تم اختيارها.

راجِع نتائج اختبار الدمج للتأكّد من أنّ الخلاصة وواجهة برمجة التطبيقات fulfillment API تعملان على النحو المتوقّع. يجب أن يكون معدّل النجاح لديك ‎95% على الأقل لكل اختبار. بالنسبة إلى حالات الاختبار ذات معدّل النجاح المنخفض، يمكنك الحصول على مزيد من المعلومات عن رسائل الخطأ المرتبطة بها من خلال النقر على حالة الاختبار.

ملاحظة: يمكنك العثور على مزيد من المعلومات عن أداة اختبار الدمج المبرمَج في الأدوات.

الاختبار يدويًا باستخدام أداة الاختبار السريع

يمكنك اختبار إجراءات الدفع والإرسال باستخدام خلاصة بيانات صالحة للخدمة الكاملة للطلب. تستخدِم عملية الاختبار هذه أداة الاختبار السريع للتوغّل في مسار طلب المستخدم ومحاكاة عملية الدفع في سلة التسوّق وإرسال الطلب.

لإجراء الاختبار يدويًا باستخدام خلاصة البيانات، اتّبِع الخطوات التالية:

1. انتقِل إلى لوحات البيانات > الاختبار السريع في مركز الإجراءات.
2. استخدِم تحميل ملف لتحميل خلاصة البيانات التي تريد استخدامها للاختبار. يجب أن يكون الملف بتنسيق NDJSON.
3. بعد انتهاء عملية التحميل، انقر على إرسال.
4. انتظِر إلى أن يعالج النظام ملف خلاصة البيانات. قد يستغرق ذلك بضع دقائق. يتمّ إعادة تحميل الجدول تلقائيًا.
5. بعد ظهور الحالة نجاح، انقر على اختبار سريع.
6. أدخِل في حقل اختبار واجهة برمجة التطبيقات نقطة نهاية واجهة برمجة التطبيقات للوفاء التي تريد اختبارها.
7. انقر على اختبار سريع لبدء عملية الطلب.

8. اتّبِع خطوات عملية الطلب الشاملة من خلال اختيار المطعم الذي تريده وإنشاء سلة تسوّق.

   ملاحظة: إذا لم يظهر مطعم أو تعذّر عليك طلب الطعام من المطعم، تأكَّد من أنّك سجّلت المطعم في الملف التجاري على Google، ومن أنّ كيان Restaurant المقابل يتضمّن الاسم والعنوان الصحيحَين. يجب أن تتطابق قيمتَي name وaddress للكيان Restaurant مع الاسم والعنوان المسجَّلين في "ملف تجاري على Google".

9. اختبِر نقطة نهاية الدفع من خلال النقر على الزر الدفع.

   

10. إذا كان الدفع ناجحًا، اختبِر نقطة نهاية إرسال الطلب من خلال النقر على زر تقديم الطلب.

    

11. في حال إرسال الطلب بنجاح، تعرض الواجهة صفحة تأكيد تحتوي على تفاصيل طلبك.

    

مراجع إضافية

بالإضافة إلى الخطوات الموضّحة أعلاه، يمكنك استخدام أدوات وحدة التحكّم لمزيد من اختبار عملية توصيل الطلبات وتحديد المشاكل وحلّها.

يمكنك الرجوع إلى الأدوات التالية للحصول على إرشادات إضافية:

• تُخرج وحدة تحكّم أدوات مطوري البرامج في Chrome تنسيق JSON للطلب والاستجابة بين وحدة التحكّم ونقطة نهاية التسليم. يمكنك الرجوع إلى هذه النتائج أثناء إجراء اختبار يدوي لتحديد المشاكل المحدّدة وحلّها.
• تُصدِر نقطة نهاية التسليم سجلّات Stackdriver إلى وحدة تحكّم Google Cloud. إذا كنت بصدد تحديد المشاكل وحلّها في رمز إشباع الطلب، يمكنك الرجوع إلى هذه السجلات للحصول على رسائل الخطأ التفصيلية.