Договор аренды временно удерживает право собственности на запрошенный слот.
Серверная часть партнера проверяет, что запрошенный интервал встречи действителен и по-прежнему доступен. Внутренне партнер создает временное удержание для запрошенного слота, срок действия которого истекает автоматически в lease_expiration_time . Серверной части разрешено изменять lease_expiration_time , например, если запрошенное время аренды слишком велико. Созданная аренда возвращается клиенту.
Наш API бронирования обеспечивает дополнительную поддержку аренды. При поддержке аренды создание аренды для запрошенного слота является первым шагом при создании бронирования.
// 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;
}
Дополнительная информация об аренде
Поддержка аренды не является обязательной . Это касается партнеров, заинтересованных в реализации поддержки. Прежде чем начать, свяжитесь с Центром действий, чтобы определить право на участие.
Для поддержки аренды необходимо реализовать рекомендуемый набор API v2; кроме того,
- CreateLease необходимо реализовать.
- CreateBooking должен быть реализован и, как ожидается, будет использовать ссылку на аренду. Серверная часть партнера выполняет бронирование, используя предоставленный номер аренды.
Требования API v2 также применяются к поддержке аренды; кроме того,
- Ожидается, что CreateBooking будет использовать ссылку на аренду. При бронировании с использованием предоставленного ссылки на аренду партнер использует аренду и делает ее недействительной для дальнейших бронирований. Партнер также несет ответственность за проверку созданного бронирования с использованием слота в сообщении запроса.
- В качестве дополнительного кода ошибки gRPC NOT_FOUND используется, если указана ссылка на аренду, а идентификатор аренды неизвестен партнеру.
