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

يحتفظ عقد الإيجار مؤقتًا بملكية "موضع الإعلان" المطلوب.

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

توفّر واجهة برمجة التطبيقات الخاصة بالحجز دعمًا اختياريًا لـ 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;
}

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

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

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

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

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

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

الشكل: إنشاء حجز لعقد إيجار