ข้อกำหนดเฉพาะเกี่ยวกับการเช่า

การเช่าจะถือครองการเป็นเจ้าของช่องที่ขอไว้ชั่วคราว

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

Booking API ของเรารองรับการเช่าแบบไม่บังคับ เมื่อรองรับการเช่า การสร้างการเช่าสำหรับช่วงเวลาที่ขอจะเป็นขั้นตอนแรกในการสร้างการจอง

// Temporary lease for an inventory slot
message Lease {
  // ID of the lease.
  // Not populated in CreateLeaseRequest. The value is chosen by the partner and
  // has to be returned in the response of CreateLease. (required)
  string lease_id = 1;

  // The appointment slot that the lease is created for. (required)
  Slot slot = 2;

  // Unique identifier for this lease, chosen by Reserve with Google. Serves as
  // an idempotency token for [ext.maps.booking.partner.v2.CreateLease]
  // requests. (required)
  string user_reference = 3;

  // Expiration time of the lease in UTC Timestamp (required)
  google.protobuf.Timestamp lease_expiration_time = 4;
}

// Reference to a [ext.maps.booking.partner.v2.Lease] that has been created via
// [ext.maps.booking.partner.v2.CreateLease]
message LeaseReference {
  // Lease ID (required)
  string lease_id = 1;
}

ข้อมูลเพิ่มเติมเกี่ยวกับสัญญาเช่า

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

หากต้องการรองรับการเช่า คุณต้องติดตั้งชุด API v2 ที่แนะนำ นอกจากนี้

  • คุณต้องติดตั้งใช้งาน CreateLease
  • ต้องติดตั้งใช้งาน CreateBooking และคาดว่าจะใช้ข้อมูลอ้างอิงการเช่า แบ็กเอนด์ของพาร์ทเนอร์ทำการจองด้วยข้อมูลอ้างอิงการเช่าที่ระบุ

ข้อกำหนดของ API v2 จะมีผลกับการสนับสนุนการเช่าด้วย นอกจากนี้

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