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)

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

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
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 الحجز في انتظار تأكيد العميل قبل أن ينتقل إلى الحالة CONFIRMED (هذه الحالة غير متاحة حاليًا)
CANCELED تم إلغاء الحجز نيابةً عن المستخدم.
NO_SHOW لم يحضر العميل الموعد
NO_SHOW_PENALIZED لم يحضر العميل الموعد، ما يشكّل انتهاكًا لسياسة الإلغاء.
FAILED تعذّر إكمال الحجز بسبب حدوث خطأ في المعالجة.
DECLINED_BY_MERCHANT رفض التاجر الحجز بشكل غير متزامن.

PaymentInformation

تفاصيل الدفع المتعلّقة بالحجز

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

enum (PrepaymentStatus)

حالة الدفعة المسبقة للحجز إذا كانت قيمة 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 حاليًا.