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 حدث خطأ أثناء معالجة الدفعة لأنّ نوع بطاقة الائتمان المقدَّم لم يقبلّه التاجر. يجب تقديم نوع بطاقة الائتمان في rejectedCardType.
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

طلب مصادقة الدفع ليتم نشرها في نموذج ACSUrl إذا تم تقديمها.
transactionId

string

معرّف يستخدمه موفّر خدمة إدارة الهوية وإمكانية الوصول ليتم نشره في نموذج ACSUrl إذا تم تقديمه.
mdMerchantData

string

بيانات التاجر ليتم نشرها في نموذج ACSUrl إذا تم تقديمها.