- แหล่งข้อมูล: ความพร้อมใช้งาน
- แหล่งข้อมูล
- การเกิดซ้ำ
- ScheduleException
- DurationRequirement
- SchedulingRuleOverrides
- ConfirmationMode
- เมธอด
ทรัพยากร: ความพร้อมใช้งาน
ช่วงเวลาที่พร้อมให้บริการของผู้ขาย เวลาที่ระบุและจำนวนที่นั่ง
การแสดง JSON |
---|
{ "startTime": string, "duration": string, "spotsTotal": string, "spotsOpen": string, "availabilityTag": string, "resources": { object ( |
ช่อง | |
---|---|
startTime |
เวลาเริ่มต้นของช่วงเวลาที่สะดวกสำหรับนัดหมาย การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
duration |
ระยะเวลาของช่วงการนัดหมาย ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย " |
spotsTotal |
จำนวนสปอตรวมทั้งหมดและร้านเปิดสำหรับห้องว่างนี้ ตัวอย่าง
หมายเหตุ: หากส่งคำขอโดยใช้รูปแบบการบีบอัดข้อมูลความพร้อมใช้งานที่กำหนดด้านล่าง ระบบจะอนุมานทั้ง 2 ช่องนี้
|
spotsOpen |
จำนวนสปอตที่ยังว่างอยู่ |
availabilityTag |
สตริงทึบแสง (ไม่บังคับ) สำหรับระบุช่องความพร้อมใช้งานนี้ หากตั้งค่าไว้ เวลาดังกล่าวจะรวมอยู่ในคำขอที่จอง/อัปเดต/ยกเลิกการนัดหมาย |
resources |
ทรัพยากรเสริมที่ใช้แยกช่วงเวลาว่างนี้จากผู้อื่นเมื่อมีเจ้าหน้าที่แต่ละคนหรือห้องเป็นส่วนหนึ่งของบริการ เช่น ชั้นเรียนโยคะเดียวกันที่มีผู้สอน 2 คน
|
paymentOptionId[] |
รายการรหัสที่อ้างอิงถึงตัวเลือกการชำระเงินที่สามารถใช้ชำระเงินสำหรับช่องนี้ ตัวเลือกการชำระเงินจริงจะกำหนดที่ระดับผู้ขาย และสามารถแชร์กับผู้ขายหลายๆ รายได้ ช่องนี้จะลบล้าง payment_option_ids ที่ระบุไว้ในข้อความบริการ payment_options_ids ที่ระบุไว้ที่นี่คล้ายกันไม่จำเป็นต้องอยู่ในข้อความบริการ แต่ต้องกำหนดในระดับผู้ขายด้วย |
recurrence |
ข้อมูลการเกิดซ้ำสำหรับเวลาว่าง ซึ่งแสดงเวลาเริ่มต้นมากกว่า 1 ครั้ง การเกิดซ้ำควรมีการนัดหมายเป็นเวลา 1 วันทำการ |
scheduleException[] |
เวลาที่ไม่สามารถกำหนดเวลาบริการนี้ หากต้องการจำกัดจำนวนข้อความ scheduleException ให้พิจารณารวมข้อยกเว้นที่อยู่ติดกัน |
deposit |
ทางเลือกมัดจำสำหรับความพร้อมจำหน่ายสินค้านี้ แทนที่เงินมัดจำหากระบุไว้ |
noShowFee |
ค่าธรรมเนียมการไม่แสดงตัว (ไม่บังคับ) สำหรับความพร้อมจำหน่ายสินค้านี้ ลบล้างค่าธรรมเนียมสำหรับการไม่แสดงบริการหากระบุไว้ |
requireCreditCard |
ระบุว่าผู้ใช้ต้องระบุบัตรเครดิตเพื่อจองช่วงเวลาว่างนี้หรือไม่ หากไม่ได้ตั้งค่า ค่าจะรับค่าจากระดับบริการหากมีการตั้งค่าไว้ (ไม่บังคับ) |
ticketTypeId[] |
ระบุรายการประเภทตั๋วที่รองรับสำหรับช่องความพร้อมใช้งานนี้ หากไม่ได้ตั้งค่า ตั๋วทุกประเภทในบริการหลักจะพร้อมใช้งานสำหรับช่องนี้ โปรดทราบว่าต้องกำหนดค่าของช่องนี้ในบริการหลัก ตัวอย่าง
วิธีเป็นตัวแทนของพื้นที่โฆษณาในช่วงวันธรรมดา
หากต้องการระบุว่าตั๋วทั้ง 3 ประเภทพร้อมให้บริการในช่วงเวลาดังกล่าว ให้ใช้ (ไม่บังคับ) |
durationRequirement |
ข้อกำหนดในการแสดงระยะเวลาของสล็อตและ/หรือเวลาสิ้นสุด ระบบจะไม่สนใจช่องนี้หากช่องโฆษณาไม่พร้อมใช้งาน ไม่ได้ใช้ในประเภทธุรกิจกิจกรรมน่าสนใจ (ไม่บังคับ) |
schedulingRuleOverrides |
กฎการกำหนดเวลาเวลาว่าง หากมีการเติมข้อมูลในช่อง ช่องเหล่านั้นจะลบล้างกฎการกำหนดเวลาที่เกี่ยวข้องใน Schedule Rules ระดับบริการ |
confirmationMode |
โหมดการยืนยันที่จะใช้เมื่อจองห้องว่างนี้ ความพยายามในการสร้างการจองสำหรับความพร้อมที่มีโหมดการยืนยัน CONFIRMATION_MODE_SYNCHRONOUS ต้องได้รับการยืนยันหรือปฏิเสธโดยทันที ความพยายามในการสร้างการจองสำหรับความพร้อมให้บริการที่มีโหมดการยืนยัน CONFIRMATION_MODE_ASYNCHRONOUS ต้องถูกปฏิเสธทันทีหรือสร้างด้วยสถานะรอดำเนินการ |
แหล่งข้อมูล
ระบบใช้ทรัพยากรเพื่อแยกช่วงเวลาว่างของแต่ละช่วงไว้อย่างชัดเจนเมื่อมีเจ้าหน้าที่แต่ละคนหรือห้องเป็นส่วนหนึ่งของบริการ สล็อตหลายสล็อตสำหรับบริการและช่วงเวลาเดียวกันสามารถอยู่ร่วมกันได้เมื่อมีทรัพยากรแตกต่างกัน
การแสดง JSON |
---|
{ "staffId": string, "staffName": string, "roomId": string, "roomName": string, "partySize": integer } |
ช่อง | |
---|---|
staffId |
รหัสที่ไม่บังคับสำหรับเจ้าหน้าที่ที่ให้บริการ ช่องนี้จะระบุเจ้าหน้าที่ในข้อมูลของผู้ขาย บริการ และความพร้อมจำหน่ายสินค้าทั้งหมด และต้องมีความเสถียรเมื่อเวลาผ่านไปเพื่อให้มีความเชื่อมโยงกับการจองที่ผ่านมา ช่องนี้ต้องมีช่องหากมี StaterName อยู่ |
staffName |
ชื่อที่ไม่บังคับของเจ้าหน้าที่ที่ให้บริการ ระบบจะแสดงช่องนี้แก่ผู้ใช้ที่ทำการจอง และควรให้มนุษย์อ่านได้ ไม่ใช่ตัวระบุแบบทึบ ช่องนี้ต้องมีช่อง StaokId อยู่ |
roomId |
รหัส (ไม่บังคับ) สำหรับห้องพักที่มีบริการ ช่องนี้ระบุห้องในข้อมูลผู้ขาย บริการ และห้องว่างทั้งหมด และต้องมีความเสถียรเมื่อเวลาผ่านไปเพื่อให้มีความเชื่อมโยงกับการจองที่ผ่านมา ช่องนี้ต้องแสดงหากมี roomName อยู่ |
roomName |
ชื่อ (ไม่บังคับ) สำหรับห้องที่มีบริการ ระบบจะแสดงช่องนี้แก่ผู้ใช้ที่ทำการจอง และควรให้มนุษย์อ่านได้ ไม่ใช่ตัวระบุแบบทึบ (ไม่บังคับแต่ต้องระบุหากมี RoomId อยู่) ชื่อห้องสำหรับห้องอาหารควรใช้สำหรับพื้นที่นั่งเล่น เช่น บาร์หรือนอกชานเท่านั้น และไม่ควรใช้กับเมนูราคาคงที่ กิจกรรมพิเศษ หรือค่าอื่นๆ ที่ไม่ใช่ห้อง (เช่น การจองหรืออาหารค่ำ) ขอแนะนำอย่างยิ่งว่าพื้นที่ที่นั่งเริ่มต้นไม่ควรเชื่อมโยงกับห้อง |
partySize |
ใช้ได้กับการรับประทานอาหารเท่านั้น: จำนวนแขกที่เข้าพักในช่วงเวลานี้ได้ ร้านอาหารจะเชื่อมโยงกับสล็อตหลายสล็อตพร้อมกันได้ แต่ละร้านจะระบุ partySize ที่แตกต่างกัน ในกรณีที่จองโต๊ะสำหรับแขก 2, 3 หรือ 4 คน |
การเกิดซ้ำ
ข้อความการเกิดซ้ำเป็นตัวเลือกที่ไม่บังคับ แต่จะช่วยให้นำเสนอช่วงเวลาว่างที่เกิดซ้ำแบบสม่ำเสมอมากขึ้น ซึ่งมักแสดงตารางการทำงานในแต่ละวัน จากนั้นระบบจะใช้ข้อความ ScheduleException เพื่อแสดงช่วงเวลาที่จอง/ไม่พร้อมใช้งานภายในวันทำงาน
ข้อกำหนด
- การขยายสล็อตความพร้อมใช้งานหรือการเกิดซ้ำต้องไม่สร้างช่องโฆษณาที่เหมือนกัน หากรหัส, เวลาเริ่มต้น, ระยะเวลา และทรัพยากรตรงกัน ช่องโฆษณาจะเหมือนกัน
- อย่ารวมรูปแบบความพร้อมจำหน่ายสินค้ามาตรฐานและการเกิดซ้ำภายในช่วงเวลาของบริการเดียว การเกิดซ้ำจะเป็นประโยชน์ต่อผู้ขาย/บริการที่มีการนัดหมาย รูปแบบมาตรฐานจะมุ่งเน้นไปที่ผู้ขาย/บริการที่มีชั้นเรียนที่กำหนดเวลาไว้เป็นประจำ
- การเกิดซ้ำไม่ควรเกิน 24 ชั่วโมง
การแสดง JSON |
---|
{ "repeatUntil": string, "repeatEvery": string } |
ช่อง | |
---|---|
repeatUntil |
การประทับเวลา UTC สูงสุดโดยรวมที่ความพร้อมใช้งานจะเกิดซ้ำจนถึง การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
repeatEvery |
กำหนดเวลาระหว่างช่วงว่างที่ต่อเนื่องกัน ตัวอย่างเช่น เวลาว่างที่มีระยะเวลา 20 นาที ช่วงเวลาเกิดซ้ำทุก 30 นาที เวลาเริ่มต้นเป็น 9.00 น. และทำซ้ำจนถึง 11:00 น. จะมีช่วงที่ว่างในเวลา 9-9:20 น., 9:30 - 9:50 น., 10-10:20 น., 10:30-10:50 น., 10:30 น. - 10:50 น. (ต้องระบุ) ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย " |
ScheduleException
ข้อความ ScheduleException จะแสดงช่วงเวลาที่จอง/ไม่ว่างภายในวันทำงาน ซึ่งเป็นข้อยกเว้นสำหรับการเกิดซ้ำที่อธิบายไว้ข้างต้น เมื่อมีการจองช่วงเวลาแล้ว คุณควรอัปเดตรายการข้อยกเว้นเพื่อแสดงช่วงเวลาใหม่ที่ไม่พร้อมให้บริการ ไม่ควรแก้ไขการเกิดซ้ำ
การแสดง JSON |
---|
{
"timeRange": {
object ( |
ช่อง | |
---|---|
timeRange |
ช่วงเวลาของข้อยกเว้น ช่วงเวลาใดๆ ที่อธิบายจากการเกิดซ้ำซึ่งซ้อนทับกับช่วงเวลาเปิดทำการที่ปิดไปแล้วจะถือว่าไม่พร้อมใช้งาน ตัวอย่าง: ถ้าการเกิดซ้ำระบุระยะเวลาเป็น 20 นาที การทำซ้ำทุกๆ 30 นาที เวลาเริ่มต้นเป็น 9:00 น. และทำซ้ำจนถึง 11:00 น. การใช้ ScheduleException ที่มีช่วงเวลา 9:45am - 11:00am จะทำให้ช่วงเวลาไม่ว่าง:9:30-9:50am, 10:00am และ 10:00น. โปรดทราบว่าเนื่องจากช่วงเวลานั้นปิดหรือเปิดอยู่ ระบบจึงไม่ส่งผลกระทบต่อช่วงเวลา 11:00 น. |
DurationRequirement
Enum นี้จะระบุข้อกำหนดที่ผู้ใช้มีอยู่เพื่อรับทราบหรือดูระยะเวลา/เวลาสิ้นสุดที่ขอ
Enum | |
---|---|
DURATION_REQUIREMENT_UNSPECIFIED |
ไม่ได้ระบุการจัดการเวลาสิ้นสุด โดยตัวเลือกนี้คือค่าเริ่มต้น |
DO_NOT_SHOW_DURATION |
เวลาสิ้นสุดจะไม่แสดงให้ผู้ใช้เห็น |
MUST_SHOW_DURATION |
เวลาสิ้นสุดต้องแสดงต่อผู้ใช้ก่อนจึงจะทำการนัดหมายได้ |
SchedulingRuleOverrides
กฎการกำหนดเวลาระดับความพร้อมใช้งาน
การแสดง JSON |
---|
{ "lastBookableSec": string, "firstBookableSec": string, "lastOnlineCancellableSec": string } |
ช่อง | |
---|---|
lastBookableSec |
เวลาล่าสุด (เป็นวินาที) ที่จองช่วงเวลานี้ได้ การประทับเวลานี้ต้องอยู่ก่อน startSec ของสล็อตที่จะยึดตามเวลาดังกล่าว (หากผู้ใช้ควรจองได้หลังเวลาเริ่มต้น ให้ใช้ Schedulerules.min_booking_before_end_time ในระดับบริการ) หากมี จะลบล้างทุกอย่างที่ระบุใน min_booking_buffer ของ อย่างมาก TimingRule ของบริการที่เกี่ยวข้อง |
firstBookableSec |
ครั้งแรก (เป็นวินาที) ที่จองช่องนี้ได้ การประทับเวลานี้ต้องอยู่ก่อน startSec ของช่อง หรือ lastBookableSec หากระบุไว้ |
lastOnlineCancellableSec |
หากตั้งค่าไว้ เวลาล่าสุด (เป็นวินาทีนับตั้งแต่ Epoch ของ Unix) ที่คุณจะยกเลิกช่วงเวลาที่สะดวกสำหรับนัดหมายนี้ผ่าน "จองกับ Google" ได้ ช่องนี้จะลบล้างกฎการยกเลิกระดับบริการทั้งหมด (ไม่บังคับ) |
ConfirmationMode
โหมดการยืนยันที่ใช้เมื่อการจองความพร้อม
Enum | |
---|---|
CONFIRMATION_MODE_UNSPECIFIED |
ไม่ได้ระบุโหมดการยืนยัน ต้องใช้การยืนยันแบบพร้อมกัน |
CONFIRMATION_MODE_SYNCHRONOUS |
ระบบจะยืนยันการจองห้องว่างนี้แบบพร้อมกัน |
CONFIRMATION_MODE_ASYNCHRONOUS |
ระบบจะยืนยันการจองสำหรับห้องว่างนี้แบบไม่พร้อมกัน |
วิธีการ |
|
---|---|
|
แทนที่Availability ของService ที่มีอยู่ของผู้ขายที่จัดการโดยผู้รวบรวมข้อมูลที่ระบุ และส่งคืนสินค้าดังกล่าว |