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