索引
TimeOfDayRange（消息）TimeOfDayWindow（消息）ValidTimeException（消息）ValidityPeriod（消息）ValidityRange（消息）ValidityScope（枚举）
TimeOfDayRange
[START time_range_definition] 开始营业到结束营业的时间范围。
| 字段 | |
|---|---|
open_time |
一个时间，表示范围中一天的开始时间（含）。如果未设置，则表示 00:00:00。可选。 |
close_time |
一个时间，表示范围中一天的结束时间（不含）。如果未设置，则表示 23:59:59。可选。 |
TimeOfDayWindow
TimeWindow 对象是一个复合实体，用于描述用户可以下单或完成订单的一系列时间窗口。[START time_window_definition]
| 字段 | |
|---|---|
time_windows |
可以下单/完成订单的时间窗口。必填。 |
day_of_week[] |
应用时间窗口的一周中的日期列表。如果未设置，则表示适用于一周中的所有日期。可选。 |
ValidTimeException
[START valid_time_exception_definition]
| 字段 | |
|---|---|
exceptional_period |
优惠券无效的开始和结束时间戳。这些时间必须表示不同的日期，即开始时间必须是 00:00（一天的开始），结束时间必须是异常期结束当天 00:00（不含）。 |
ValidityPeriod
[START validity_period_definition]
| 字段 | |
|---|---|
valid_period |
优惠券有效的开始和结束时间戳。这些时间必须表示不同的日期，即开始时间必须是 00:00（一天的开始），结束时间必须是有效期结束当天 00:00（不含）。 |
time_of_day[] |
指定给定日期内的有效时间间隔，以及哪些日期可使用优惠。对于跨午夜的时间范围（例如晚上 10 点到凌晨 2 点），请为每一天使用单独的时间窗口：一个时间窗口在晚上 11:59:59 结束，另一个时间窗口在次日凌晨 12:00 开始。例如：周一：上午 10 点到下午 5 点；周二：上午 10 点到下午 2 点；周二：下午 5 点到晚上 7 点；周三、周四、周五、周六、周日：下午 3 点到晚上 7 点。如果未设置，则表示优惠在 |
time_exceptions[] |
指定上述 valid_period 和 valid_time_of_week 的例外情况 |
date_exceptions[] |
指定上述 valid_period 和 time_of_day 的例外日期 |
validity_scope |
指定有效期的范围。 |
validity_duration_in_days |
优惠券/折扣券在购买后有效的时长（以天为单位）。 |
ValidityRange
[START validity_range_definition] 开始营业到结束营业的时间戳范围。
| 字段 | |
|---|---|
valid_from_time |
范围的开始时间（含）。必填。 |
valid_through_time |
范围的结束时间（不含）。如果未设置，则表示此时间段永不结束。可选。 |
ValidityScope
[START validity_scope_definition] 有效期的范围；即此有效期适用于哪些操作。
| 枚举 | |
|---|---|
VALIDITY_SCOPE_UNSPECIFIED |
|
VALIDITY_SCOPE_CLAIM |
|
VALIDITY_SCOPE_REDEEM |
|