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

ملاحظة: إنّ الإيجارات اختيارية في الإصدار الثاني من واجهة برمجة التطبيقات، وننصح باستخدامها بدلاً من ذلك، يُرجى التحقّق من مدى التوفّر.

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

// Temporary lease for an inventory slot
message Lease {
  // ID of the lease. Ignored when creating a lease.
  string lease_id = 1;

  // ID of the merchant for the slot
  string merchant_id = 2;

  // ID of the merchant service
  string service_id = 3;

  // Start time of the appointment slot
  google.protobuf.Timestamp start_time = 4;

  // Duration of the appointment slot
  google.protobuf.Duration duration = 5;

  // Opaque tag that identifies the availability slot and matches the value
  // provided in the availability feed.
  string availability_tag = 8;

  // The set of resources that disambiguates the appointment slot, e.g. by
  // indicating the staff member and room selected by the user.
  Resources resources = 9;

  // Unique identifier for this lease, chosen by the client. Serves as an
  // idempotency token for [ext.maps.booking.partner.v0.CreateLease] requests.
  string client_reference = 6;

  // Expiration time of the lease
  google.protobuf.Timestamp lease_expiration_time = 7;
}

// Reference to a [ext.maps.booking.partner.v0.Lease] that has been created via
// [ext.maps.booking.partner.v0.CreateLease]
message LeaseReference {
  // Lease ID
  string lease_id = 1;
}