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

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

string

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

string

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