เมธอด CreateLease

การสนับสนุนการสร้างสัญญาเช่าเป็นแบบไม่บังคับ โดยจะมีผลกับพาร์ทเนอร์ที่ สนใจจะใช้ฟังก์ชันนี้ โปรดติดต่อ Actions Center เพื่อตรวจสอบการมีสิทธิ์ก่อนเริ่มต้น

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

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

คำขอ

CreateLeaseRequest

ผลลัพธ์

CreateLeaseResponse

ข้อกำหนด

• lease_id ต้องสร้างขึ้นโดยแบ็กเอนด์ของพาร์ทเนอร์และตั้งค่าไว้ใน CreateLeaseResponse.
• ต้องตั้งค่า lease_expiration_time ใน CreateLeaseResponse
• หากระบุฟิลด์ทรัพยากรใน CreateLeaseRequest ต้อง ไว้ใน CreateLeaseResponse และจับคู่ CreateLeaseRequest ได้ด้วย
• ช่องอื่นๆ ทั้งหมดใน CreateLeaseResponse ต้องตั้งค่าและตรงกับ CreateLeaseRequest.

รหัสข้อผิดพลาด gRPC ของ Canonical

• 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;
}