REST Resource: inventory.partners.merchants.services.availability

{
  "startTime": string,
  "duration": string,
  "spotsTotal": string,
  "spotsOpen": string,
  "availabilityTag": string,
  "resources": {
    object (Resources)
  },
  "paymentOptionId": [
    string
  ],
  "recurrence": {
    object (Recurrence)
  },
  "scheduleException": [
    {
      object (ScheduleException)
    }
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "prepayment": {
    object (Prepayment)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "ticketTypeId": [
    string
  ],
  "durationRequirement": enum (DurationRequirement),
  "schedulingRuleOverrides": {
    object (SchedulingRuleOverrides)
  },
  "confirmationMode": enum (ConfirmationMode),
  "linkoutRequiredReason": enum (LinkoutRequiredReason)
}

string (Timestamp format)

预约空档的开始时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Duration format)

预约空档的持续时间

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

string (int64 format)

此可用性的总空档数和可用空档数。示例：

• 瑜伽课有 10 个空档，其中 3 个已预订：availability {spotsTotal: 10, spotsOpen: 7 ...}
• 按摩椅服务空档已订满：availability {spotsTotal: 1, spotsOpen: 0 ...}

注意：如果使用下面指定的可用性压缩格式发送请求，将推断出以下两个字段。

• Recurrence 表示 spotsTotal=1 和 spotsOpen=1。
• ScheduleException 表示 spotsTotal=1 和 spotsOpen=0。

string (int64 format)

可用的空档数。

string

用于标识可用性空档的可选不透明字符串。如果设置该字段，它将包含在预订/更新/取消预约的请求中。

object (Resources)

当服务中包含不同的工作人员或房间时，用于消除此可用性空档与其他空档之间的歧义的可选资源。

例如，同一瑜伽课程有 2 位老师：

availability { resources { staffId: "1" staffName: "Amy" }
               spotsTotal: 10 spotsOpen: 7 }
availability { resources { staffId: "2" staffName: "John" }
               spotsTotal: 5 spotsOpen: 2 }

string

ID 列表，其中列出了可用于支付此空档费用的付款方式。实际的付款方式需在商家级别定义，且多个商家可共享付款方式。

该字段将替换服务消息中指定的任何 payment_option_ids。同样，此处指定的 payment_option_ids 无需在服务消息中显示，但必须在商家级别定义。

object (Recurrence)

可用性的重复周期信息，表示多个开始时间。重复周期应包含单个工作日内的可预约项。

object (ScheduleException)

无法安排此服务的时间。如需限制 scheduleException 消息的数量，请考虑整合相邻的例外情况。

object (Deposit)

适用于此可用性的可选押金。如果指定了押金，则会替换在服务级别定义的押金。

object (NoShowFee)

适用于此可用性的可选违约金。如果指定了违约金，则会替换在服务级别定义的违约金。

object (Prepayment)

可选。适用于此可用性的可选预付款信息。

enum (RequireCreditCard)

表明用户是否必须提供信用卡信息才能预订此可用性空档。如果未设置该值，将从服务级别（如果已在该级别设置）继承。（可选）

string

表示此可用性空档支持的票券类型列表。如果未设置该值，则父级服务中的所有票券类型均适用于此空档。请注意，必须在父级服务中定义此字段的值。示例：

• 具有四种票券类型的服务：TicketType {ticketTypeId: "adult_1" shortDescription: "Adult weekdays"} TicketType {ticketTypeId: "adult_2" shortDescription: "Adult weekends"} TicketType {ticketTypeId: "youth_1" shortDescription: "Youth weekdays"} TicketType {ticketTypeId: "youth_2" shortDescription: "Youth weekends"}

如需表示工作日期间的商品目录，请使用：availability {ticketTypeId: "adult_1" ticketTypeId: "youth_1"...}。如需表示节假日期间的商品目录，请使用：availability {ticketTypeId: "adult_2" ticketTypeId: "youth_2"...}。

• 具有三种门票类型的服务：TicketType {ticketTypeId: "adult" shortDescription: "Adult"} TicketType {ticketTypeId: "youth" shortDescription: "Youth"} TicketType {ticketTypeId: "senior" shortDescription: "Senior"}

如需表示这三种票券类型均适用于此时间空档，请使用 availability {ticketTypeId: "adult" ticketTypeId: "youth" ticketTypeId: "senior" ...} 或 `availability {...}'（在此空档内不设置 ticketTypeId）。

（可选）

enum (DurationRequirement)

显示时段时长和/或结束时间的要求。如果播出信息不适用，系统会忽略此字段。不适用于推荐活动行业。（可选）

object (SchedulingRuleOverrides)

可用性时间安排规则。填充后，这些字段将替换服务级 SchedulingRules 上的任何相应的时间安排规则。

enum (ConfirmationMode)

表示预订此可用性时使用哪种确认模式。使用 CONFIRMATION_MODE_SYNCHRONOUS 的确认模式创建可用性的预订时，必须立即确认或拒绝。使用 CONFIRMATION_MODE_ASYNCHRONOUS 的确认模式创建可用性的预订时，必须立即拒绝或创建为 PENDING 的状态。

enum (LinkoutRequiredReason)

可选。此槽位需要链出的原因。如果已设置，此槽位对应的商家资源必须具有有效的 LinkoutTemplate。（可选）

{
  "staffId": string,
  "staffName": string,
  "roomId": string,
  "roomName": string,
  "partySize": integer,
  "roomDescription": {
    object (Text)
  }
}

string

提供服务的工作人员的可选 ID。此字段用于标识所有商家、服务和可用性记录中的工作人员。此外，考虑到需与之前的预订相关联，此字段需要随着时间的推移保持一致。如果存在 staffName，则必须显示此字段。

string

提供服务的工作人员的可选姓名。办理预订的用户将看到此字段，该字段应该是用户可理解的内容，而非不透明的标识符。如果存在 staffId，则必须显示此字段。

string

服务所在房间的可选 ID。此字段用于标识所有商家、服务和可用性记录中的房间。此外，考虑到需与之前的预订相关联，此字段需要随着时间的推移保持一致。如果存在 roomName，则必须显示此字段。

string

服务所在房间的可选名称。办理预订的用户将看到此字段，该字段应该是用户可理解的内容，而非不透明的标识符。（可选，但如果存在 roomId，则必须提供）在餐饮中，房间名称应仅用于酒吧或露台等座位区域，不应用于固定价格菜单、特殊活动或任何其他非客房值（例如预订或晚餐）。强烈建议不要将默认休息区与房间相关联。

integer

仅适用于餐饮服务：此时间空档内可容纳的就餐人数。一家餐厅可以同时与多个空档相关联，每个空档可指定一个不同的 partySize，例如可预订 2 人、3 人或 4 人位。

object (Text)

可选。本地化的聊天室说明。如果设置，则必须提供默认值。最好还提供商家所在语言区域的常用语言。（可选）

{
  "repeatUntil": string,
  "repeatEvery": string
}

string (Timestamp format)

可用性重复截止时间的时间戳，需包含最大时间单位的世界协调时间 (UTC)。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Duration format)

定义连续可用性空档之间的时间。

示例：持续时间为 20 分钟、repeatEvery 为 30 分钟、startTime 为上午 9:00、repeatUntil 为上午 11:00 的可用性将在上午 9:00-9:20、上午 9:30-9:50、上午 10:00-10:20、上午 10:30-10:50 和上午 11:00-11:20 生成空档。（必填）

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

{
  "timeRange": {
    object (TimeRange)
  }
}

object (TimeRange)

例外情况的时间范围。由重复周期描述且与此已打烊-营业中时间范围重叠的任何空档都将被视为不可用。

示例：如果重复周期指定时长为 20 分钟、repeatEvery 为 30 分钟、startTime 为上午 9:00 且 repeatUntil 为上午 11:00，则 timeRange 为上午 9:45-11:00 的 ScheduleException 会使上午 9:30-9:50、上午 10-10:20 和上午 10:30-10:50 的空档不可用。

请注意，由于时间范围为已打烊-营业中，因此，从上午 11 点开始的空档不会受到影响。

{
  "priceInfo": {
    object (PriceInfo)
  }
}

object (PriceInfo)

用于显示价格详情的容器。

{
  "priceType": enum (PriceType),

  // Union field price_options can be only one of the following:
  "price": {
    object (Price)
  },
  "priceRange": {
    object (PriceRange)
  }
  // End of list of possible types for union field price_options.
}

enum (PriceType)

定义价格或价格范围的应用方式（按人或固定）

object (Price)

服务的价格或所需费用。

object (PriceRange)

服务或费用的上限和/或下限。

{
  "minPrice": {
    object (Price)
  },
  "maxPrice": {
    object (Price)
  }
}

object (Price)

最低金额。

object (Price)

最高金额。应始终大于 minPrice。

{
  "lastBookableSec": string,
  "firstBookableSec": string,
  "lastOnlineCancellableSec": string
}

string (int64 format)

可预订此空档的最后时间（以秒为单位）。此时间戳必须在要预订的空档的 startSec 之前（如果用户在开始时间之后也可预订，请使用服务级别 SchedulingRules.min_booking_before_end_time）。如果存在此字段，将替换相应服务 SchedulingRules 的 min_booking_buffer 中任何指定的内容。

string (int64 format)

能够预订此空档的最早时间（以秒为单位）。此时间戳必须在该空档的 startSec 或 lastBookableSec（如果指定）之前。

string (int64 format)

如果已设置，则表示可通过“通过 Google 预订”功能取消此特定预约空档的最后时间（以 Unix 纪元为起始值，以秒为单位）。此字段将替换任何服务级取消规则。（可选）