CreateLease yöntemi

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

Kiralama desteğiyle rezervasyon oluşturmanın ilk adımı kiralamayı oluşturmaktır. İş ortağı arka uç, istenen randevu aralığının geçerli ve müsait olup olmadığını doğrular. İş ortağı, istenen slot için dahili olarak geçici bir bekletme işlemi oluşturur. Bu işlem, lease_expiration_time zamanında otomatik olarak sona erecek şekilde ayarlanır. Arka uç, lease_expiration_time değerini değiştirebilir (ör. istenen kiralama süresi çok uzunsa). Oluşturulan kiralama istemciye döndürülür. Ardından müşteri, kiralama için rezervasyon oluşturma isteğinde bulunur.

Kira sözleşmesi oluşturma işlemi, işletme mantığı hatası nedeniyle başarısız olursa hata yanıta eklenmelidir. 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 uç tarafından oluşturulmalı ve CreateLeaseResponse'ta ayarlanmalıdır.
  • CreateLeaseResponse'ta lease_expiration_time ayarlanmalıdır.
  • resources alanı CreateLeaseRequest'te belirtilmişse CreateLeaseResponse'te ayarlanmalı ve CreateLeaseRequest ile eşleşmelidir.
  • CreateLeaseResponse'teki 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 aralık zamanı spesifikasyonu)
// 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 {
  // 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 {
  // 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;
}