مشخصات اجاره

یک اجاره‌نامه به طور موقت مالکیت یک اسلات درخواستی را در اختیار دارد.

بخش پشتیبانی همکار، اعتبار و در دسترس بودن بازه زمانی درخواستی را تأیید می‌کند. در داخل، همکار یک وقفه موقت برای بازه زمانی درخواستی ایجاد می‌کند که طوری تنظیم شده است که به طور خودکار در lease_expiration_time منقضی شود. بخش پشتیبانی اجازه دارد lease_expiration_time تغییر دهد، مثلاً اگر زمان اجاره درخواستی بیش از حد طولانی باشد. اجاره ایجاد شده به مشتری بازگردانده می‌شود.

API رزرو ما پشتیبانی اختیاری برای Lease ارائه می‌دهد. با پشتیبانی از Lease، ایجاد Lease برای اسلات درخواستی اولین قدم هنگام ایجاد رزرو است.

// Temporary lease for an inventory slot
message Lease {
  option features.(pb.java).nest_in_file_class = YES;

  // 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 {
  option features.(pb.java).nest_in_file_class = YES;

  // Lease ID (required)
  string lease_id = 1;
}

اطلاعات تکمیلی در مورد اجاره نامه

پشتیبانی برای اجاره اختیاری است. این پشتیبانی شامل شرکایی می‌شود که علاقه‌مند به اجرای این پشتیبانی هستند. لطفاً قبل از شروع، برای تعیین واجد شرایط بودن با مرکز اقدامات تماس بگیرید.

برای پشتیبانی از اجاره، مجموعه توصیه‌شده API نسخه ۲ باید پیاده‌سازی شود؛ علاوه بر این،

• پیاده‌سازی CreateLease الزامی است.
• پیاده‌سازی CreateBooking الزامی است و انتظار می‌رود از مرجع اجاره استفاده کند. بخش پشتیبانی همکار، رزرو را با مرجع اجاره ارائه شده انجام می‌دهد.

الزامات API نسخه ۲ همچنین برای پشتیبانی از اجاره اعمال می‌شود؛ علاوه بر این،

• انتظار می‌رود CreateBooking از مرجع اجاره استفاده کند. هنگام رزرو با مرجع اجاره ارائه شده، شریک اجاره را مصرف می‌کند و آن را برای هرگونه رزرو بعدی نامعتبر می‌کند. شریک همچنین مسئول تأیید رزرو ایجاد شده با استفاده از اسلات در پیام درخواست است.
• به عنوان یک کد خطای اضافی gRPC، اگر lease ref ارائه شده باشد و lease ID برای شریک ناشناخته باشد، از NOT_FOUND استفاده می‌شود.

شکل: ایجاد رزرو برای اجاره