การสนับสนุนการสร้างการเช่าเป็นแบบไม่บังคับ ซึ่งจะมีผลกับพาร์ทเนอร์ ที่สนใจจะใช้ฟังก์ชันนี้ โปรดติดต่อศูนย์การดำเนินการเพื่อพิจารณาสิทธิ์ก่อนที่คุณจะเริ่มต้น
ขั้นตอนแรกในการสร้างการจองพร้อมการสนับสนุนการเช่า แบ็กเอนด์ของพาร์ทเนอร์ยืนยันว่าช่วงเวลาที่สะดวกสำหรับนัดหมายที่ขอนั้นถูกต้องและว่าง พาร์ทเนอร์สร้างการระงับชั่วคราวสำหรับช่องที่ขอไว้ภายในระบบ ซึ่งตั้งค่าให้หมดอายุโดยอัตโนมัติในเวลา lease_expiration_time แบ็กเอนด์ได้รับอนุญาตให้แก้ไข lease_expiration_time เช่น เวลาเช่าที่ขอนานเกินไป ค่าเช่าที่สร้างขึ้นจะถูกส่งคืนให้กับลูกค้า จากนั้นลูกค้าก็ขอให้สร้างการจองสำหรับการเช่า
หากสร้างการเช่าไม่สำเร็จเนื่องจากข้อผิดพลาดด้านตรรกะทางธุรกิจ ควรระบุข้อผิดพลาดนั้นในการตอบกลับ ดูการจอง ไม่สำเร็จสำหรับข้อมูลอย่างละเอียด
คำขอ
สร้างคำขอเช่า
ผลลัพธ์
CreateLeaseResponse
ข้อกำหนด
- lease_id ต้องสร้างขึ้นโดยแบ็กเอนด์ของพาร์ทเนอร์และตั้งค่าใน CreateLeaseResponse
- ต้องตั้งค่า lease_expiration_time ใน CreateLeaseResponse
- หากมีการระบุช่องทรัพยากรใน CreateLeaseRequest ต้องตั้งค่าช่องดังกล่าวใน CreateLeaseResponse และตรงกับ CreateLeaseRequest
- ต้องตั้งค่าช่องอื่นๆ ทั้งหมดใน CreateLeaseResponse และตรงกับ CreateLeaseRequest
รหัสข้อผิดพลาด gRPC ตามรูปแบบบัญญัติ
INVALID_ARGUMENT(รหัสผู้ขาย รหัสบริการ หรือข้อกำหนดเวลาของช่วงเวลาไม่ถูกต้อง)
// Request to create a [ext.maps.booking.partner.v2.Lease] for a slot in the
// inventory. The expiration time in the returned Lease may be modified by the
// backend, e.g. if the requested lease period is too long.
message CreateLeaseRequest {
// The lease to be created with information about the appointment slot
// (required)
Lease lease = 1;
}
// Response for the [ext.maps.booking.partner.v2.CreateLease] RPC with the
// created [ext.maps.booking.partner.v2.Lease]
message CreateLeaseResponse {
// The created [ext.maps.booking.partner.v2.Lease] (required)
Lease lease = 1;
// If creating a lease fails, this field should reflect the business logic
// error (e.g., slot has become unavailable) and lease field is expected to be
// unset. (required if failure occurs)
BookingFailure booking_failure = 2;
}