لإكمال مهمة "إنجاز" في مرحلة "جاهز" من CreateBooking، عليك إنشاء طريقة CreateBooking وتسليمها بنجاح. يتم استدعاء هذه الطريقة عندما يحاول أحد المستخدمين إنشاء حجز. إذا تم إنشاء حجز بنجاح، يتضمّن الردّ booking_id فريدًا للإشارة إلى الحجز في الطلبات أو التعديلات المستقبلية.
متطلبات مهمة CreateBooking
- 10 طلبات
CreateBookingفي البيئة التجريبية بمعدّل نجاح يبلغ% 90 أو أعلى - 3 طلبات
CreateBookingفي بيئة الإنتاج بمعدّل نجاح يبلغ% 90 أو أعلى
أساسيات CreateBooking
عندما يبدأ المستخدم حجزًا، يتم إرسال طلب CreateBooking إلى "خادم الحجز" الشريك. يشير الردّ على الطلب إلى نجاح الحجز أو فشله. في حال فشل الحجز، يجب أن يتضمّن الردّ خطأ منطق العمل التجاري الذي أدّى إلى الفشل. على سبيل المثال، إذا أصبح الموعد غير متاح أو إذا سبق أن حجزه المستخدم نفسه.
عندما ينشئ المستخدم حجزًا، ترسل إليك Google الاسم الأول واسم العائلة ورقم الهاتف والبريد الإلكتروني للمستخدم. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة مطابقة الحسابات وإنشائها.
الاستجابة نفسها للطلب نفسه
لا يمكن الاعتماد دائمًا على الاتصال عبر الشبكة، ويمكن أن تعيد Google محاولة طلبات HTTP إذا لم يتم تلقّي أي ردّ. لهذا السبب، يجب أن تكون جميع الطرق التي تغيّر الحالة متطابقة:
CreateBookingUpdateBooking
بالنسبة إلى كل رسالة طلب، باستثناء UpdateBooking، يتم تضمين رموز مميّزة للاستجابة نفسها للطلب نفسه لتحديد الطلب بشكل فريد. يتيح لك ذلك التمييز بين عملية إعادة محاولة استدعاء REST، بهدف إنشاء طلب واحد وطلبَين منفصلَين. تساعد معرّفات إدخالات الحجز الخاصة بـ UpdateBooking في تحديدها بشكل فريد، لذا لا يتم تضمين أي رمز مميّز للاستجابة نفسها للطلب نفسه في طلباتها.
في ما يلي بعض الأمثلة على كيفية تعامل "خوادم الحجز" مع الاستجابة نفسها للطلب نفسه:
يتضمّن ردّ
CreateBookingHTTP الناجح على `CreateBooking` الحجز الذي تم إنشاؤه. في بعض الحالات، تتم معالجة الدفعة كجزء من عملية الحجز. إذا تم تلقّيCreateBookingRequestنفسه مرة ثانية باستخدامidempotency_tokenنفسه، يجب عرضCreateBookingResponseنفسه. لا يتم إنشاء حجز ثانٍ، ويتم تحصيل الرسوم من المستخدم مرة واحدة فقط، إذا كان ذلك منطبقًا.
ينطبق شرط الاستجابة نفسها للطلب نفسه على جميع الطرق التي تغيّر الحالة.