- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- BookingFailure
- السبب
- PaymentFailureInformation
- ThreeDS1Parameters
لتعديل Booking
حالي
طلب HTTP
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
booking.name |
اسم مورد الحجز: |
معلمات طلب البحث
المَعلمات | |
---|---|
updateMask |
قناع حقل لكل حقول الحجز المطلوب تعديله هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
bookingFailure |
في حال تعذّرت معالجة طلب حجز تم تأكيده بشكل غير متزامن وتم تعديل حالة الحجز إلى "تعذّر"، يجب أن يعكس هذا الحقل الخطأ المنطقي للنشاط التجاري (على سبيل المثال، لدى المستخدم حجز حالي في وقت قريب جدًا من هذا الوقت). يجب ضبط هذا الحقل فقط عند تعديل حالة الحجز إلى "تعذّر الحجز"، وسيتم تجاهله في الحالات الأخرى. |
نص الطلب
يحتوي نص الطلب على مثال Booking
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Booking
.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/mapsbooking
BookingFailure
بيانات الحالة التي توضح سبب تعذّر معالجة الحجز بشكلٍ غير متزامن. يهدف BookingFailure بشكل أساسي إلى رصد الأخطاء المنطقية في النشاط التجاري.
تمثيل JSON |
---|
{ "cause": enum ( |
الحقول | |
---|---|
cause |
سبب تعذّر الحجز. (معلومات مطلوبة) |
rejectedCardType |
(مطلوب فقط إذا كان السبب هو PAYMENT_ERROR_card_TYPE_REJECTED) |
description |
يُستخدَم هذا الحقل الاختياري للشريك لتضمين معلومات إضافية لأغراض تصحيح الأخطاء فقط. (اختياري) |
paymentFailure |
معلومات عن حالات تعذُّر الدفع. |
السبب
تعداد أسباب الفشل.
عمليات التعداد | |
---|---|
CAUSE_UNSPECIFIED |
القيمة التلقائية: لا تستخدِم القيمة التلقائية، وتكون هذه القيمة هي "خطأ غير معروف". |
SLOT_UNAVAILABLE |
لم تعُد خانة مدى التوفّر المُشار إليها متاحة. |
SLOT_ALREADY_BOOKED_BY_USER |
سبق أن حجز المستخدم موعدًا لخانة مدى التوفّر المُشار إليها. |
LEASE_EXPIRED |
انتهت صلاحية عقد الإيجار (إذا تم تقديمه) ولا يمكن استخدامه لإكمال الحجز المطلوب. |
OUTSIDE_CANCELLATION_WINDOW |
يتعذّر تنفيذ عملية الإلغاء المطلوبة في الوقت الحالي بسبب القيود الزمنية المفروضة على سياسة الإلغاء التي يتّبعها التاجر. |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
حدث خطأ أثناء معالجة عملية الدفع لأنّ التاجر لم يقبل نوع بطاقة الائتمان الذي قدّمته. يجب تقديم نوع بطاقة الائتمان في revealCardType. |
PAYMENT_ERROR_CARD_DECLINED |
حدث خطأ أثناء معالجة عملية الدفع بسبب رفض بطاقة الائتمان المقدمة. |
PAYMENT_OPTION_NOT_VALID |
حدث خطأ في الحزمة أو الاشتراك المستخدَم في دفع رسوم الحجز. لم تكن هناك استخدامات صالحة متبقية، أو ربما انتهت صلاحيتها، وما إلى ذلك. |
PAYMENT_ERROR |
حدث خطأ أثناء معالجة عملية الدفع لهذا الحجز. استخدِم هذه القيمة للإشارة إلى خطأ عام متعلق بالدفع فقط إذا لم يتطابق الخطأ مع خطأ معيّن في الدفع أعلاه. |
USER_CANNOT_USE_PAYMENT_OPTION |
لا يمكن للمستخدم استخدام خيار الدفع المحدّد (على سبيل المثال، يحاول المستخدم استخدام سعر للمرة الأولى للمرة الثانية). |
BOOKING_ALREADY_CANCELLED |
تم إلغاء حجز حاول المستخدم إلغائه. |
BOOKING_NOT_CANCELLABLE |
لا يمكن إلغاء الحجز الذي حاول المستخدم إلغاءه. |
OVERLAPPING_RESERVATION |
لدى المستخدم حجز حالي في وقت قريب جدًا من هذا الوقت. |
USER_OVER_BOOKING_LIMIT |
تعذّر الحجز لأنّ المستخدم تجاوز الحد الأقصى للحجوزات التي يستخدمها مجمّع السلع لكل مستخدم. |
PAYMENT_REQUIRES_3DS1 |
يمكنك تحديد الحالات التي يتم فيها رفض الدفعة لأنّك تطلب إعادة محاولة إجراء المعاملة، ولكن هذه المرة بعد الخضوع لاختبار/استجابة 3DS1. يُرجى العِلم أنّ حالة تعذُّر المعاملة الحالية ستبقى غير ناجحة. ستكون إعادة المحاولة منفصلة تمامًا. إذا كان هذا هو سبب الإخفاق، يجب ضبط paymentFailure.3DS1_parameters. وإذا لم يكن الأمر كذلك، فسيتم التعامل مع السبب الحالي كما لو كان PAYMENT_ERROR. |
PaymentFailureInformation
معلومات عن حالات تعذُّر الدفع.
تمثيل JSON |
---|
{
"threeds1Parameters": {
object ( |
الحقول | |
---|---|
threeds1Parameters |
المعلَمات التي يستخدمها مُجمِّع نماذج RwG لبدء بروتوكول مصادقة 3DS1 مع المستخدم. سيتم تجاهلها ما لم يتم ضبط BookingFailure.cause على PAYMENT_REQUIRES_3DS1. |
ThreeDS1Parameters
المعلَمات التي تطلب RwG أن تنفِّذ تحدي 3DS1.
يتم تعيين المعلمات عن طريق وصف EMVCo لبروتوكول 3DS1.
تمثيل JSON |
---|
{ "acsUrl": string, "paReq": string, "transactionId": string, "mdMerchantData": string } |
الحقول | |
---|---|
acsUrl |
عنوان URL المطلوب منه تحميل نموذج لعرضه على المستخدم للمصادقة. |
paReq |
طلب المصادقة على PaymentAuth سيتم نشرها في نموذج ACSUrl في حال توفّره. |
transactionId |
معرّف يستخدمه موفّر خدمة ACS. سيتم نشرها في نموذج ACSUrl في حال توفّره. |
mdMerchantData |
بيانات التاجر سيتم نشرها في نموذج ACSUrl في حال توفّره. |