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。