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 "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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 حالي