Создание договора аренды является первым шагом при записи на прием. Серверная часть партнера проверяет, что запрошенный интервал встречи действителен и по-прежнему доступен. Внутренне партнер создает временное удержание для запрошенного слота, срок действия которого истекает автоматически в lease_expiration_time . Серверной части разрешено изменять lease_expiration_time , например, если запрошенное время аренды слишком велико. Созданная аренда возвращается клиенту.
// Temporary lease for an inventory slotmessageLease{// ID of the lease. Ignored when creating a lease.stringlease_id=1;// ID of the merchant for the slotstringmerchant_id=2;// ID of the merchant servicestringservice_id=3;// Start time of the appointment slotgoogle.protobuf.Timestampstart_time=4;// Duration of the appointment slotgoogle.protobuf.Durationduration=5;// Opaque tag that identifies the availability slot and matches the value// provided in the availability feed.stringavailability_tag=8;// The set of resources that disambiguates the appointment slot, e.g. by// indicating the staff member and room selected by the user.Resourcesresources=9;// Unique identifier for this lease, chosen by the client. Serves as an// idempotency token for [ext.maps.booking.partner.v0.CreateLease] requests.stringclient_reference=6;// Expiration time of the leasegoogle.protobuf.Timestamplease_expiration_time=7;}// Reference to a [ext.maps.booking.partner.v0.Lease] that has been created via// [ext.maps.booking.partner.v0.CreateLease]messageLeaseReference{// Lease IDstringlease_id=1;}
[null,null,["Последнее обновление: 2025-01-04 UTC."],[[["Leases are optional in v2 and primarily used for creating temporary holds on appointment slots before booking."],["The `Lease` message contains information like merchant and service IDs, appointment details, resources, and an expiration time managed by the partner backend."],["`LeaseReference` allows referencing a previously created `Lease` using its unique ID."],["Partners verify slot availability and create a temporary hold using `CreateLease`, returning the `Lease` to the client."],["`client_reference` serves as an idempotency token for `CreateLease` requests ensuring unique lease creation."]]],["When booking an appointment, a lease is created to temporarily hold the requested slot. The partner verifies the slot's availability and sets an automatic expiration (`lease_expiration_time`). This lease includes a unique `lease_id`, `merchant_id`, `service_id`, `start_time`, `duration`, `availability_tag`, and associated `resources`. The client provides a `client_reference` for idempotency. The backend can adjust the `lease_expiration_time`. The created lease or a `leaseReference` with the `lease_id` is returned. Leases are optional in v2 of the API.\n"]]