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

يملك الإيجار بشكل مؤقت ملكية الشريحة المطلوبة.

تتحقّق الواجهة الخلفية للشريك من أنّ خانة المواعيد المطلوبة صالحة لا يزال متاحًا. داخليًا، يفرض الشريك عملية تعليق مؤقتة الخانة المطلوبة، التي تم إعدادها لتنتهي صلاحيتها تلقائيًا في 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 المطلوب تنفيذه ومن المتوقع أن يستخدم مرجع الإيجار. شريكي/شريكتي تقوم الخلفية بإجراء حجز بمرجع الإيجار المقدم.

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

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

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