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

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

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

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

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

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

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

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

الاختبار

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

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

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

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

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

لاختبار معالِجات الدفع وإرسال الطلب لواجهة برمجة التطبيقات fulfillment API، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

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

8. انتقل خلال تدفق الطلب من البداية إلى النهاية عن طريق تحديد المطعم المطلوب وبناء عربة التسوق.

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

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

   

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

    

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

    

مراجع إضافية

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

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

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