نظرة عامة

**ملاحظة:** يُرجى إنشاء طلب دعم جديد في "مدخل الشركاء" إذا كنت مهتمًا بتفعيل ميزة "إعادة التوجيه إلى الدفعات".

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

الأهلية

لإضافة دفعات إلى حجوزات معيّنة، يجب استيفاء المتطلبات الأساسية التالية:

1. عملية تكامل شاملة حالية ومباشرة
2. إمكانية الانتقال مباشرةً إلى صفحة حجز يمكنها معالجة الدفعات
3. ضمان الامتثال لـ سياسات إعادة التوجيه إلى الدفعات

خطوات تنفيذ ميزة "إعادة التوجيه إلى الدفعات"

1. إعداد نموذج عنوان URL والحقول الإضافية
2. تحديد أنواع الدفعات للفتحات
3. تفعيل ميزة تتبُّع الإحالات الناجحة لعملية التكامل

ملاحظة مهمة: على الشركاء الذين يستخدمون ميزة "التعديلات في الوقت الفعلي" (RTU) تعديلها لتضمين حقول "إعادة التوجيه إلى الدفعات" الجديدة. يمكنك الاطّلاع على التعديلات على واجهة برمجة التطبيقات في الوقت الفعلي لمزيد من المعلومات.

تعديلات الحجز

يصف هذا القسم كيفية تفاعل تعديلات الحجز وعمليات الإلغاء مع ميزة "إعادة التوجيه إلى الدفعات"، بما في ذلك استبعاد الفتحات ومعالجة الأخطاء.

الحجوزات التي تتم من خلال ميزة "إعادة التوجيه إلى الدفعات"

تتم الحجوزات التي يتم إنشاؤها من خلال ميزة "إعادة التوجيه إلى الدفعات" مباشرةً على منصة الحجز الخاصة بالشريك. لا تخزّن Google هذه الحجوزات أو تديرها، لذا لا يمكن للمستخدمين الاطّلاع عليها أو تعديلها من خلال الحجز عبر Google. يجب إجراء أي تعديلات أو عمليات إلغاء للحجوزات التي تتم من خلال ميزة "إعادة التوجيه إلى الدفعات" مباشرةً على منصة الشريك.

تعديل الحجوزات الشاملة

عندما يعدّل مستخدم حجزًا شاملاً حاليًا (تم إنشاؤه في الأصل باستخدام CreateBooking)، تستبعد Google تلقائيًا جميع الفتحات التي تم وضع علامة عليها باستخدام linkout_required_reason: PAYMENT_REQUIRED من الخيارات المتاحة في طريقة عرض التعديل (ما يجعلها غير متاحة أو باللون الرمادي). يمنع ذلك المستخدمين من تبديل حجز شامل إلى فتحة تتطلب إعادة التوجيه إلى الدفعات (مثل فتحة تتطلب إيداعًا) بدون إكمال الدفعة.

معالجة طلبات `UpdateBooking`

لا يتيح نقطة نهاية واجهة برمجة التطبيقات UpdateBooking نقل المستخدم إلى مسار "إعادة التوجيه إلى الدفعات" أو عرض عنوان URL لإعادة التوجيه. في حال تلقّي خادم الشريك طلب UpdateBooking لفتحة تتطلب إعادة التوجيه إلى الدفعات (مثل فتحة تتطلب إيداعًا) (على سبيل المثال، إذا حاول مستخدم إجراء تعديل قبل أن يتم نشر مدى التوفّر المعدّل بالكامل في جميع ذاكرات التخزين المؤقت للخادم)، فمن غير المرجّح حدوث ذلك:

• ارفض الطلب من خلال عرض UpdateBookingResponse يحتوي على booking_failure.
• سبب الخطأ: اضبط booking_failure.cause على SLOT_UNAVAILABLE. يؤدي ذلك إلى عرض رسالة واضحة للمستخدم ("عذرًا، لم يعُد هذا الوقت متاحًا.") ويمنع إرسال رسائل إلكترونية غير صحيحة للتأكيد.
• وصف الخطأ: قدِّم وصفًا واضحًا (مثل "UpdateBooking not allowed on PR slots") في booking_failure.description لتسهيل التسجيل وتحديد المشاكل وحلّها.

الاختبار في "ألعاب الاستكشاف والابتكار"

بعد تفعيل ميزة "إعادة التوجيه إلى الدفعات" لعملية التكامل الخاصة بالشريك، يمكن التحقّق من هذا السلوك مباشرةً في بيئة "ألعاب الاستكشاف والابتكار":

1. أنشئ حجزًا شاملاً عاديًا باستخدام CreateBooking.
2. قدِّم فتحات مدى التوفّر تتضمّن مزيجًا من الفتحات العادية والفتحات التي تتطلب PAYMENT_REQUIRED.
3. افتح الحجز في طريقة عرض إدارة الحجوزات في "ألعاب الاستكشاف والابتكار" لمحاولة إجراء تعديل وتأكَّد من أنّ الفتحات التي تتطلب PAYMENT_REQUIRED تظهر على أنّها غير متاحة (باللون الرمادي).
4. تأكَّد من أنّ الخادم يرفض طلبات UpdateBooking غير المتوقّعة للفتحات المدفوعة التي تتطلب SLOT_UNAVAILABLE.