CreateLease yöntemi

Kiralama oluşturma desteği isteğe bağlıdır. Bu işlevselliği uygulamak isteyen iş ortakları için geçerlidir. Başlamadan önce uygunluk durumunu belirlemek için lütfen İşlemler Merkezi ile iletişime geçin.

Kiralama sözleşmesi oluşturmak, kiralama desteğiyle rezervasyon oluşturmanın ilk adımıdır. İş ortağı arka ucu, istenen randevu aralığının geçerli ve kullanılabilir olduğunu doğrular. İş ortağı, dahili olarak istenen yer için geçici bir bekletme oluşturur. Bu bekletme, lease_expiration_time tarihinde otomatik olarak sona erecek şekilde ayarlanır. İstenen kiralama süresi çok uzunsa arka uç, lease_expiration_time değerini değiştirebilir. Oluşturulan kiralama istemciye döndürülür. Ardından, müşteri kiralama için rezervasyon oluşturulmasını ister.

Kiralama işlemi herhangi bir iş mantığı hatası nedeniyle başarısız olursa yanıtta hata doldurulmalıdır. Ayrıntılı bilgi için Rezervasyon Hatası başlıklı makaleyi inceleyin.

İstek

CreateLeaseRequest

Döndürülen değer

CreateLeaseResponse

Koşullar:

  • lease_id, iş ortağı arka ucu tarafından oluşturulmalı ve CreateLeaseResponse'ta ayarlanmalıdır.
  • lease_expiration_time, CreateLeaseResponse içinde ayarlanmalıdır.
  • Kaynaklar alanı CreateLeaseRequest içinde belirtilmişse CreateLeaseResponse içinde ayarlanmalı ve CreateLeaseRequest ile eşleşmelidir.
  • CreateLeaseResponse'taki diğer tüm alanlar ayarlanmalı ve CreateLeaseRequest ile eşleşmelidir.

Standart gRPC hata kodları

  • INVALID_ARGUMENT (geçersiz satıcı kimliği, hizmet kimliği veya zaman aralığı belirtimi)
// Request to create a [ext.maps.booking.partner.v2.Lease] for a slot in the
// inventory.  The expiration time in the returned Lease may be modified by the
// backend, e.g. if the requested lease period is too long.
message CreateLeaseRequest {
  option features.(pb.java).nest_in_file_class = YES;

  // The lease to be created with information about the appointment slot
  // (required)
  Lease lease = 1;
}

// Response for the [ext.maps.booking.partner.v2.CreateLease] RPC with the
// created [ext.maps.booking.partner.v2.Lease]
message CreateLeaseResponse {
  option features.(pb.java).nest_in_file_class = YES;

  // The created [ext.maps.booking.partner.v2.Lease] (required)
  Lease lease = 1;

  // If creating a lease fails, this field should reflect the business logic
  // error (e.g., slot has become unavailable) and lease field is expected to be
  // unset. (required if failure occurs)
  BookingFailure booking_failure = 2;
}