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)

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

نص الطلب

يحتوي نص الطلب على مثال 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

يتم ضبط المَعلمات من خلال وصف بروتوكول 3DS1 الصادر عن EMVCo.

تمثيل JSON 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
الحقول
acsUrl

string

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

string

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

string

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

string

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