ดัชนี
TimeOfDayRange(ข้อความ)TimeOfDayWindow(ข้อความ)ValidTimeException(ข้อความ)ValidityPeriod(ข้อความ)ValidityRange(ข้อความ)ValidityScope(enum)
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[] |
ระบุช่วงเวลาที่ถูกต้องในวันหนึ่งๆ และวันที่ที่ข้อเสนอใช้ได้ สำหรับกรอบเวลาที่ข้ามเที่ยงคืน (เช่น 22:00 น. ถึง 02:00 น.) ให้ใช้ช่วงเวลาแยกกันสำหรับแต่ละวัน โดยช่วงเวลาหนึ่งสิ้นสุดที่ 23:59:59 น. และอีกช่วงเวลาหนึ่งเริ่มต้นที่ 00:00 น. ของวันถัดไป เช่น วันจันทร์: 10:00 น. ถึง 17:00 น. วันอังคาร: 10:00 น. ถึง 14:00 น. วันอังคาร: 17:00 น. ถึง 19:00 น. วันพุธ, พฤหัสบดี, ศุกร์, เสาร์, อาทิตย์: 15:00 น. ถึง 19:00 น. หากไม่ได้ตั้งค่าใดๆ หมายความว่าข้อเสนอจะพร้อมใช้งานตลอดเวลาภายใน |
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] ขอบเขตของระยะเวลาที่ใช้งานได้ เช่น การดำเนินการที่ระยะเวลาที่ใช้งานได้นี้มีผล
| Enum | |
|---|---|
VALIDITY_SCOPE_UNSPECIFIED |
|
VALIDITY_SCOPE_CLAIM |
|
VALIDITY_SCOPE_REDEEM |
|