مواصفات الإيجار

يمتلك عقد الإيجار مؤقتًا ملكية المساحة المطلوبة.

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

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

معلومات إضافية عن أماكن الإيجار

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

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

• يجب تنفيذ CreateLease.
• ويجب تنفيذ CreateBooking، ويتوقّع استخدام مرجع الإيجار. تقوم الواجهة الخلفية للشريك بإجراء الحجز باستخدام مرجع الإيجار المقدم.

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

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

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