مواصفات عقد الإيجار

تمنح "الملكية المؤقتة" ملكية خانة مطلوبة مؤقتًا.

تتحقّق الخلفية لدى الشريك من أنّ خانة الموعد المطلوبة صالحة ولا تزال متاحة. داخليًا، ينشئ الشريك حجزًا مؤقتًا للمساحة المطلوبة، ويتم إعداده لتنتهي صلاحيته تلقائيًا في lease_expiration_time. يُسمح للجزء الخلفي بتعديل lease_expiration_time، على سبيل المثال، إذا كان وقت الاستئجار المطلوب طويلاً جدًا. يتم إرجاع عقد الإيجار الذي تم إنشاؤه إلى العميل.

توفّر واجهة برمجة التطبيقات للحجز إمكانية اختيارية للتأجير. عند تفعيل ميزة "عقد الإيجار"، تشكل عملية إنشاء عقد إيجار للموعد المطلوب الخطوة الأولى عند إنشاء حجز.

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

معلومات إضافية حول عقود الإيجار

إنّ إتاحة عقد الإيجار اختيارية. وينطبق ذلك على الشركاء المهتمين بتنفيذ الدعم. يُرجى التواصل مع فريق "مركز الإجراءات" لتحديد أهليتك قبل البدء.

لتفعيل ميزة "الإيجار"، يجب تنفيذ المجموعة المقترَحة من الإصدار 2 من واجهة برمجة التطبيقات. بالإضافة إلى ذلك،

• يجب تنفيذ CreateLease.
• يجب تنفيذ CreateBooking ويُتوقّع أن يستخدم مرجع عقد الإيجار. يُجري Partner backend حجزًا باستخدام مرجع عقد الإيجار المقدَّم.

تنطبق متطلبات الإصدار 2 من واجهة برمجة التطبيقات أيضًا على إتاحة عقد الإيجار. بالإضافة إلى ذلك،

• من المتوقع أن يستخدم CreateBooking مرجع عقد الإيجار. عند إجراء حجز باستخدام مرجع العقد المتوفر، يستخدم الشريك العقد ويجعله غير صالح لأي حجوزات أخرى. يتحمّل الشريك أيضًا مسؤولية التحقّق من الحجز الذي تم إنشاؤه باستخدام خانة في رسالة الطلب.
• كرمز خطأ إضافي في gRPC، يتم استخدام NOT_FOUND في حال توفُّر مرجع عقد الإيجار وإذا كان رقم تعريف عقد الإيجار غير معروف للشريك.

الشكل: إنشاء حجز لمدّة إيجار