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 "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

string (Duration format)

ระยะเวลาของช่วงเวลาที่สะดวกสำหรับนัดหมาย

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย s เช่น "3.5s"

string (int64 format)

จำนวนตำแหน่งทั้งหมดและจำนวนตำแหน่งที่ว่างอยู่ของความพร้อมจำหน่ายนี้ ตัวอย่าง

• คลาสโยคะที่มี 10 ที่ว่างและมี 3 คนที่จอง: availability {spotsTotal: 10, spotsOpen: 7 ...}
• เซสชันการนวดบนเก้าอี้ที่เต็มแล้ว: availability {spotsTotal: 1, spotsOpen: 0 ...}

หมายเหตุ: หากส่งคำขอโดยใช้รูปแบบการบีบอัดความพร้อมที่ระบุไว้ด้านล่าง ระบบจะอนุมาน 2 ช่องนี้

• การเกิดซ้ำจะหมายถึง 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

รายการรหัสที่อ้างอิงถึงตัวเลือกการชำระเงินซึ่งสามารถใช้ชําระเงินสําหรับช่วงเวลานี้ได้ ตัวเลือกการชำระเงินจริงจะกำหนดที่ระดับผู้ขาย และสามารถแชร์กับผู้ขายหลายรายได้

ช่องนี้จะลบล้าง payment_option_ids ที่ระบุไว้ในข้อความบริการ ในทำนองเดียวกัน payment_option_ids ที่ระบุที่นี่ไม่จำเป็นต้องอยู่ในข้อความบริการ แต่ต้องกำหนดที่ระดับผู้ขาย

object (Recurrence)

ข้อมูลการเกิดซ้ำของความพร้อมให้บริการ ซึ่งแสดงเวลาเริ่มต้นมากกว่า 1 รายการ การประชุมที่เกิดซ้ำควรมีการนัดหมายสำหรับ 1 วันทำการ

object (ScheduleException)

เวลาที่ไม่สามารถกำหนดเวลาบริการนี้ หากต้องการจำกัดจำนวนข้อความ scheduleException ให้ลองรวมข้อยกเว้นที่อยู่ติดกัน

object (Deposit)

เงินมัดจําที่ไม่บังคับสําหรับห้องว่างนี้ ลบล้างเงินมัดจําบริการหากระบุไว้

object (NoShowFee)

ค่าธรรมเนียมการยกเลิกที่ไม่บังคับสำหรับห้องว่างนี้ ลบล้างค่าบริการหากไม่มาตามนัด หากมีการระบุไว้

object (Prepayment)

ไม่บังคับ ข้อมูลการชำระเงินล่วงหน้า (ไม่บังคับ) สำหรับความพร้อมให้บริการนี้

enum (RequireCreditCard)

ระบุว่าผู้ใช้ต้องระบุบัตรเครดิตเพื่อจองช่วงเวลาที่พร้อมให้บริการนี้หรือไม่ หากไม่ได้ตั้งค่า ค่าดังกล่าวจะรับค่ามาจากระดับบริการหากมีการตั้งค่าไว้ (ไม่บังคับ)

string

ระบุรายการประเภทตั๋วที่รองรับสำหรับช่วงเวลาที่พร้อมจำหน่ายนี้ หากไม่ได้ตั้งค่าไว้ ตั๋วทุกประเภทในบริการหลักจะใช้ได้กับช่องนี้ โปรดทราบว่าค่าของช่องนี้ต้องกำหนดไว้ในบริการหลัก ตัวอย่าง

• บริการที่มีตั๋ว 4 ประเภท ได้แก่ 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"...}

• บริการที่มีตั๋ว 3 ประเภท ได้แก่ TicketType {ticketTypeId: "adult" shortDescription: "Adult"} TicketType {ticketTypeId: "youth" shortDescription: "Youth"} TicketType {ticketTypeId: "senior" shortDescription: "Senior"}

หากต้องการระบุว่าตั๋วทั้ง 3 ประเภทพร้อมจำหน่ายในช่วงเวลานี้ ให้ใช้ availability {ticketTypeId: "adult" ticketTypeId: "youth" ticketTypeId: "senior" ...} หรือ "availability {...}" (อย่าตั้งค่า ticketTypeId ในช่องนี้)

(ไม่บังคับ)

enum (DurationRequirement)

ข้อกำหนดในการแสดงระยะเวลาของช่วงเวลาและ/หรือเวลาสิ้นสุด ระบบจะละเว้นช่องนี้หากช่องไม่พร้อมใช้งาน ไม่ได้ใช้ในประเภทกิจกรรมน่าสนใจ (ไม่บังคับ)

object (SchedulingRuleOverrides)

กฎการตั้งเวลาความพร้อมใช้งาน หากมีการป้อนข้อมูลในช่อง ช่องเหล่านั้นจะลบล้างกฎการกําหนดเวลาที่เกี่ยวข้องใน SchedulingRules ระดับบริการ

enum (ConfirmationMode)

โหมดการยืนยันที่จะใช้เมื่อจองห้องว่างนี้ การพยายามสร้างการจองสำหรับห้องว่างที่มีโหมดการยืนยันเป็น CONFIRMATION_MODE_SYNCHRONOUS ต้องได้รับการยืนยันหรือปฏิเสธทันที การพยายามสร้างการจองสำหรับความพร้อมที่มีโหมดการยืนยันของ CONFIRMATION_MODE_ASYNCHRONOUS ต้องถูกปฏิเสธทันทีหรือสร้างด้วยสถานะ "รอดำเนินการ"

enum (LinkoutRequiredReason)

ไม่บังคับ เหตุผลที่ต้องใช้ลิงก์เอาต์สำหรับช่องนี้ หากตั้งค่าไว้ ทรัพยากรของผู้ขายสำหรับช่องนี้ต้องมี LinkoutTemplate ที่ถูกต้อง (ไม่บังคับ)

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

string

รหัสพนักงานที่ให้บริการ (ไม่บังคับ) ช่องนี้จะระบุพนักงานในบันทึกผู้ขาย บริการ และห้องว่างทั้งหมด นอกจากนี้ ข้อมูลยังต้องมีความเสถียรเมื่อเวลาผ่านไปเพื่อให้เชื่อมโยงกับการจองที่ผ่านมาได้ ช่องนี้ต้องมีข้อมูลหากมี staffName

string

ชื่อพนักงานที่ให้บริการ (ไม่บังคับ) ช่องนี้จะแสดงต่อผู้ใช้ที่ทำการจอง และควรเป็นข้อมูลที่มนุษย์อ่านได้ ไม่ใช่ตัวระบุแบบทึบ ช่องนี้ต้องมีข้อมูลหากมี staffId

string

รหัสที่ไม่บังคับสำหรับห้องที่มีบริการ ช่องนี้จะระบุห้องพักในบันทึกผู้ขาย บริการ และห้องว่างทั้งหมด นอกจากนี้ ข้อมูลยังต้องมีความเสถียรเมื่อเวลาผ่านไปเพื่อให้เชื่อมโยงกับการจองที่ผ่านมาได้ ช่องนี้ต้องมีข้อมูลหากมี roomName อยู่

string

ชื่อที่ไม่บังคับสำหรับห้องที่ให้บริการ ช่องนี้จะแสดงต่อผู้ใช้ที่ทำการจอง และควรเป็นข้อมูลที่มนุษย์อ่านได้ ไม่ใช่ตัวระบุแบบทึบ (ไม่บังคับ แต่ต้องระบุหากมี roomId) ในส่วนอาหารและเครื่องดื่ม คุณควรใช้ชื่อห้องกับพื้นที่นั่งเท่านั้น เช่น บาร์หรือระเบียง และไม่ควรใช้กับเมนูราคาคงที่ กิจกรรมพิเศษ หรือค่าอื่นๆ ที่ไม่ใช่ห้องพัก (เช่น การจองหรืออาหารเย็น) เราขอแนะนำอย่างยิ่งว่าพื้นที่นั่งเล่นเริ่มต้นไม่ควรเชื่อมโยงกับห้อง

integer

ใช้ได้กับ "การรับประทานอาหาร" เท่านั้น: จำนวนแขกที่รองรับได้ในช่วงเวลานี้ ร้านอาหารหนึ่งๆ สามารถเชื่อมโยงกับหลายช่วงเวลาพร้อมกัน โดยแต่ละช่วงเวลาจะระบุจำนวนคนที่แตกต่างกัน เช่น รองรับการจองได้ 2, 3 หรือ 4 คน

object (Text)

ไม่บังคับ คำอธิบายห้องพักที่แปลแล้ว หากตั้งค่าไว้ คุณต้องระบุค่าเริ่มต้น เราขอแนะนำให้ระบุภาษาทั่วไปสำหรับภาษาท้องถิ่นของผู้ขายด้วย (ไม่บังคับ)

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

string (Timestamp format)

การประทับเวลา UTC สูงสุดแบบรวมที่ระบุเวลาที่ความพร้อมใช้งานจะแสดงซ้ำ

การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

string (Duration format)

กำหนดเวลาระหว่างช่วงเวลาที่ว่างติดต่อกัน

ตัวอย่างเช่น ความพร้อมที่มีระยะเวลา 20 นาที, repeatEvery 30 นาที, startTime 9:00 น. และ repeatUntil 11:00 น. จะให้ช่วงเวลาที่ 9-9:20 น., 9:30-9:50 น., 10-10:20 น., 10:30-10:50 น., 11-11:20 น. (ต้องระบุ)

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย s เช่น "3.5s"

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

object (TimeRange)

ช่วงเวลาของข้อยกเว้น ระบบจะถือว่าช่วงเวลาที่สะดวกสำหรับนัดหมายที่ระบุโดยความถี่ซึ่งทับซ้อนกับช่วงปิด-เปิดนี้ไม่พร้อมให้บริการ

ตัวอย่างเช่น หากความถี่ระบุระยะเวลา 20 นาที, repeatEvery 30 นาที, startTime 9:00 น. และ repeatUntil 11:00 น. นั้น ScheduleException ที่มี timeRange 9:45 น. - 11:00 น. จะทําให้ช่วงเวลา 9:30-9:50 น., 10-10:20 น. และ 10:30-10:50 น. ไม่พร้อมใช้งาน

โปรดทราบว่าเนื่องจากช่วงเวลาเป็นแบบปิด-เปิด ช่วงเวลาที่เริ่มต้นตอน 11:00 น. จะไม่ได้รับผลกระทบ

{
  "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 ระดับบริการ) หากมี จะลบล้างสิ่งที่ระบุไว้ใน min_booking_buffer ของ SchedulingRules ของบริการที่เกี่ยวข้อง

string (int64 format)

เวลาที่จองได้ครั้งแรก (เป็นวินาที) ของช่วงเวลานี้ การประทับเวลานี้ต้องอยู่ก่อน startSec ของช่วงเวลา หรือ lastBookableSec หากระบุ

string (int64 format)

หากตั้งค่าไว้ จะเป็นเวลาที่สุดท้าย (เป็นวินาทีนับจาก Unix Epoch) ที่ยกเลิกช่วงเวลาที่เจาะจงของการนัดหมายผ่านฟีเจอร์จองกับ Google ได้ ช่องนี้จะลบล้างกฎการยกเลิกระดับบริการ (ไม่บังคับ)