مشخصات اجاره

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

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

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

// 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 از مرجع اجاره استفاده کند. هنگام رزرو با مرجع اجاره ارائه شده، شریک اجاره نامه را مصرف می کند و آن را برای رزروهای بعدی بی اعتبار می کند. شریک همچنین مسئول تأیید رزرو ایجاد شده با استفاده از اسلات در پیام درخواست است.
  • به عنوان یک کد خطای اضافی gRPC، در صورتی که کد اجاره نامه ارائه شده باشد و شناسه اجاره برای شریک ناشناخته باشد، از NOT_FOUND استفاده می شود.
شکل: یک رزرو برای اجاره ایجاد کنید