Method: notification.partners.bookings.patch

لتعديل Booking حالي

طلب HTTP

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
booking.name

string

اسم مورد الحجز: partners/{partner ID}/bookings/{booking ID}

معلمات طلب البحث

المَعلمات
updateMask

string (FieldMask format)

قناع حقل لكل حقول الحجز المطلوب تعديله

هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
bookingFailure

object (BookingFailure)

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

نص الطلب

يحتوي نص الطلب على مثال Booking.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Booking.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/mapsbooking

BookingFailure

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

تمثيل JSON 
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
الحقول
cause

enum (Cause)

سبب تعذّر الحجز. (معلومات مطلوبة)
rejectedCardType

enum (CreditCardType)

(مطلوب فقط إذا كان السبب هو PAYMENT_ERROR_card_TYPE_REJECTED)
description

string

يُستخدَم هذا الحقل الاختياري للشريك لتضمين معلومات إضافية لأغراض تصحيح الأخطاء فقط. (اختياري)
paymentFailure

object (PaymentFailureInformation)

معلومات عن حالات تعذُّر الدفع.

السبب

تعداد أسباب الفشل.

عمليات التعداد
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)
  }
}
الحقول
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

string

عنوان URL المطلوب منه تحميل نموذج لعرضه على المستخدم للمصادقة.
paReq

string

طلب المصادقة على PaymentAuth سيتم نشرها في نموذج ACSUrl في حال توفّره.
transactionId

string

معرّف يستخدمه موفّر خدمة ACS. سيتم نشرها في نموذج ACSUrl في حال توفّره.
mdMerchantData

string

بيانات التاجر سيتم نشرها في نموذج ACSUrl في حال توفّره.