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

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

تمثيل 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 القيمة التلقائية: Don't use; إلى "خطأ غير معروف"
SLOT_UNAVAILABLE لم تعُد خانة مدى التوفّر المُشار إليها متاحة.
SLOT_ALREADY_BOOKED_BY_USER سبق أن حجز المستخدم موعدًا لخانة التوفّر المُشار إليها.
LEASE_EXPIRED انتهت صلاحية الإيجار (إذا تم تقديمه) ولا يمكن استخدامه بعد ذلك لإكمال الحجز المطلوب.
OUTSIDE_CANCELLATION_WINDOW يتعذّر تنفيذ طلب الإلغاء المطلوب في الوقت الحالي بسبب القيود المفروضة على الوقت في سياسة الإلغاء لدى التاجر.
PAYMENT_ERROR_CARD_TYPE_REJECTED حدث خطأ أثناء معالجة الدفعة لأنّ التاجر لم يقبل نوع بطاقة الائتمان الذي قدّمته. يجب تقديم نوع بطاقة الائتمان بـ disapprovalCardType.
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

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

transactionId

string

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

mdMerchantData

string

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