پشتیبانی برای ایجاد اجاره اختیاری است. برای شرکایی که علاقه مند به اجرای این قابلیت هستند اعمال می شود. لطفاً قبل از شروع برای تعیین صلاحیت با مرکز اقدامات تماس بگیرید.
ایجاد اجاره نامه اولین قدم هنگام ایجاد رزرو با پشتیبانی Lease است. پشتیبان شریک تأیید می کند که شکاف قرار درخواست شده معتبر و در دسترس است. در داخل، شریک یک توقف موقت برای اسلات درخواستی ایجاد می کند، که تنظیم شده است تا به طور خودکار در lease_expiration_time منقضی شود. باطن مجاز است lease_expiration_time را تغییر دهد، به عنوان مثال اگر زمان اجاره درخواستی بیش از حد طولانی باشد. اجاره ایجاد شده به مشتری بازگردانده می شود. سپس مشتری درخواست ایجاد رزرو برای اجاره می کند.
اگر ایجاد اجاره نامه به دلیل هرگونه خطای منطق تجاری با شکست مواجه شد، خطا باید در پاسخ پر شود. برای اطلاعات دقیق، به شکست رزرو مراجعه کنید.
درخواست
CreateLeaseRequest
ارزش برگشتی
CreateLeaseResponse
الزامات:
- lease_id باید توسط backend شریک ایجاد شده و در 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;
}