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 حالية.