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

空档的商家 ID

serviceId

string

商家服务的 ID

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)

预订的预付款状态。如果 prepaymentStatus 为 PREPAYMENT_PROVIDED 或 PREPAYMENT_REFUNDED,则 paymentTransactionId 包含关联的唯一交易 ID。

paymentTransactionId

string

与预订关联的付款交易的唯一标识符。如果不适用,则为空。

PrepaymentStatus

预订的预付款状态。

枚举
PREPAYMENT_STATUS_UNSPECIFIED 未指定,默认为 PREPAYMENT_NOT_PROVIDED。
PREPAYMENT_PROVIDED 预订费用已提前支付。
PREPAYMENT_NOT_PROVIDED 预订费用未提前支付。
PREPAYMENT_REFUNDED 费用原为 PREPAYMENT_PROVIDED,但已退款。

方法

patch

更新现有 Booking