Спецификация аренды

Договор аренды временно закрепляет за собой право собственности на запрошенный слот.

Бэкенд партнера проверяет, действителен ли запрошенный слот для записи и свободен ли он. Внутри системы партнер создает временную блокировку для запрошенного слота, которая автоматически истекает по истечении lease_expiration_time . Бэкенд может изменять lease_expiration_time , например, если запрошенный срок аренды слишком велик. Созданный договор аренды возвращается клиенту.

Наш API для бронирования предоставляет дополнительную поддержку аренды слотов. При наличии поддержки аренды создание договора аренды для запрашиваемого слота является первым шагом при создании бронирования.

// Temporary lease for an inventory slot
message Lease {
  option features.(pb.java).nest_in_file_class = YES;

  // 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 {
  option features.(pb.java).nest_in_file_class = YES;

  // Lease ID (required)
  string lease_id = 1;
}

Дополнительная информация об аренде

Поддержка аренды является необязательной . Она распространяется на партнеров, заинтересованных в ее внедрении. Пожалуйста, свяжитесь с Центром действий, чтобы узнать о возможности ее получения, прежде чем начать.

Для поддержки аренды необходимо реализовать рекомендуемый набор API версии 2; кроме того,

• Необходимо реализовать функцию CreateLease .
• Необходимо внедрить функцию CreateBooking , которая должна использовать ссылку на договор аренды. Партнерская система осуществляет бронирование, используя предоставленную ссылку на договор аренды.

Требования API v2 также распространяются на поддержку аренды; кроме того,

• Предполагается, что CreateBooking будет использовать ссылку на аренду. При создании бронирования с использованием предоставленной ссылки на аренду партнер использует эту аренду, делая ее недействительной для любых последующих бронирований. Партнер также отвечает за проверку созданного бронирования, используя слот в сообщении запроса.
• В качестве дополнительного кода ошибки gRPC используется NOT_FOUND, если указана ссылка на аренду, а идентификатор аренды неизвестен партнеру.

Рисунок: Создание бронирования для аренды