REST Resource: notification.partners.bookings

المرجع: الحجز

حجز خانة مستودع

تمثيل JSON
{
  "name": string,
  "merchantId": string,
  "serviceId": string,
  "startTime": string,
  "duration": string,
  "clientInformation": {
    object (ClientInformation)
  },
  "status": enum (BookingStatus),
  "paymentInformation": {
    object (PaymentInformation)
  },
  "partySize": string
}
الحقول
name

string

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

merchantId

string

معرّف التاجر للخانة

serviceId

string

رقم تعريف خدمة التاجر

startTime

string (Timestamp format)

وقت بدء خانة الموعد

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

duration

string (Duration format)

مدة خانة المواعيد

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بـ "s" مثال: "3.5s"

clientInformation

object (ClientInformation)

المعلومات الشخصية للعميل الذي يحدد الموعد

status

enum (BookingStatus)

حالة الحجز

paymentInformation

object (PaymentInformation)

معلومات عن معاملات الدفع المرتبطة بالحجز

partySize

string (int64 format)

عدد الضيوف في الحجز

ClientInformation

المعلومات الشخصية عن الشخص الذي يجري حجزًا

تمثيل JSON
{
  "givenName": string,
  "familyName": string,
  "address": {
    object (PostalAddress)
  },
  "telephone": string,
  "email": string
}
الحقول
givenName

string

الاسم الأول للعميل

familyName

string

اسم عائلة العميل

address

object (PostalAddress)

عنوان العميل

telephone

string

رقم هاتف العميل

email

string

عنوان البريد الإلكتروني للعميل

BookingStatus

حالة الحجز

عمليات التعداد
BOOKING_STATUS_UNSPECIFIED لم يتم تحديده.
CONFIRMED تم تأكيد الحجز
PENDING_MERCHANT_CONFIRMATION الحجز في انتظار تأكيد من التاجر قبل أن ينتقل إلى الحالة "تمّ التأكيد" (هذه الحالة غير متاحة حاليًا).
PENDING_CLIENT_CONFIRMATION الحجز في انتظار تأكيد من العميل قبل أن يتم نقله إلى الحالة "تمّ التأكيد" (هذه الحالة غير متاحة حاليًا).
CANCELED تم إلغاء الحجز نيابةً عن المستخدم.
NO_SHOW لم يحضر العميل الموعد
NO_SHOW_PENALIZED لم يظهر العميل للموعد الذي يخالف سياسة الإلغاء.
FAILED تعذّر إكمال الحجز بسبب تعذّر المعالجة.
DECLINED_BY_MERCHANT رفض التاجر الحجز بشكل غير متزامن.

PaymentInformation

تفاصيل الدفع المرتبطة بحجز

تمثيل JSON
{
  "prepaymentStatus": enum (PrepaymentStatus),
  "paymentTransactionId": string
}
الحقول
prepaymentStatus

enum (PrepaymentStatus)

حالة الدفعة المُسبَقة للحجز إذا كانت حالة الدفع المسبق هي PREPAYMENT_PROVIDED أو PREPAYMENT_REFUNDED، سيحتوي عنوان paymentTransactionId على معرّف المعاملة الفريد المرتبط به.

paymentTransactionId

string

المعرّف الفريد لمعاملة دفع مرتبطة بالحجز فارغ إذا لم يكن منطبقًا

PrepaymentStatus

حالة الدفعة المسبقة للحجز

عمليات التعداد
PREPAYMENT_STATUS_UNSPECIFIED لم يتم تحديده، ويتم ضبطه تلقائيًا على PREPAYMENT_NOT_PROVIDED.
PREPAYMENT_PROVIDED تم دفع رسوم الحجز مسبقًا.
PREPAYMENT_NOT_PROVIDED لم يتم دفع رسوم الحجز مقدّمًا.
PREPAYMENT_REFUNDED كانت الرسوم في السابق PREPAYMENT_PROVIDED ولكن تم ردّها الآن.

الطُرق

patch

يعدِّل Booking حالية.