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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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)

تعداد نفرات رزرو شده

اطلاعات مشتری

اطلاعات شخصی در مورد شخصی که رزرو انجام می‌دهد

نمایش JSON 
{
  "givenName": string,
  "familyName": string,
  "address": {
    object (PostalAddress)
  },
  "telephone": string,
  "email": string
}
فیلدها
givenName

string

نام داده شده مشتری

familyName

string

نام خانوادگی موکل

address

object ( PostalAddress )

آدرس مشتری

telephone

string

شماره تلفن مشتری

email

string

آدرس ایمیل مشتری

وضعیت رزرو

وضعیت رزرو

انوم‌ها
BOOKING_STATUS_UNSPECIFIED مشخص نشده است.
CONFIRMED رزرو قطعی شد
PENDING_MERCHANT_CONFIRMATION رزرو قبل از اینکه به وضعیت تأیید شده (CONFIRMED) تغییر کند، منتظر تأیید فروشنده است (این وضعیت در حال حاضر پشتیبانی نمی‌شود)
PENDING_CLIENT_CONFIRMATION رزرو قبل از اینکه به وضعیت تأیید شده (CONFIRMED) تغییر کند، منتظر تأیید مشتری است (این وضعیت در حال حاضر پشتیبانی نمی‌شود)
CANCELED رزرو از طرف کاربر لغو شده است.
NO_SHOW مشتری برای قرار ملاقات حاضر نشد
NO_SHOW_PENALIZED مشتری برخلاف سیاست لغو وقت، در قرار ملاقات حاضر نشد.
FAILED به دلیل اختلال در پردازش، رزرو انجام نشد.
DECLINED_BY_MERCHANT رزرو به صورت ناهمزمان توسط فروشنده رد شد.

اطلاعات پرداخت

جزئیات پرداخت مربوط به رزرو

نمایش JSON 
{
  "prepaymentStatus": enum (PrepaymentStatus),
  "paymentTransactionId": string
}
فیلدها
prepaymentStatus

enum ( PrepaymentStatus )

وضعیت پیش‌پرداخت رزرو. اگر وضعیت پیش‌پرداخت PREPAYMENT_PROVIDED یا PREPAYMENT_REFUNDED باشد، آنگاه paymentTransactionId حاوی شناسه تراکنش منحصر به فرد مربوطه است.

paymentTransactionId

string

شناسه منحصر به فرد برای تراکنش پرداخت مرتبط با رزرو. در صورت عدم وجود، خالی است.

وضعیت پیش‌پرداخت

وضعیت پیش‌پرداخت رزرو.

انوم‌ها
PREPAYMENT_STATUS_UNSPECIFIED مشخص نشده است، پیش‌فرض PREPAYMENT_NOT_PROVIDED است.
PREPAYMENT_PROVIDED هزینه رزرو از قبل پرداخت شده است.
PREPAYMENT_NOT_PROVIDED هزینه رزرو از قبل پرداخت نشده است.
PREPAYMENT_REFUNDED هزینه قبلاً PREPAYMENT_PROVIDED بود اما اکنون مسترد شده است.

روش‌ها

patch

 یک Booking موجود را به‌روزرسانی می‌کند.