CreateLease yöntemi

Kontrat oluşturma desteği isteğe bağlıdır. Bu, bu işlevi uygulamak isteyen iş ortakları için geçerlidir. Başlamadan önce uygun olup olmadığınızı belirlemek için lütfen İşlem Merkezi ile iletişime geçin.

Kiralama destek ekibiyle rezervasyon oluşturmanın ilk adımı kiralama işlemini oluşturmaktır. İş ortağı arka ucu, istenen randevu aralığının geçerli ve kullanılabilir olduğunu doğrular. İş ortağı, dahili olarak istenen slot için geçici bir bekletme oluşturur. Bu bekletme, lease_expiration_time tarihinde otomatik olarak sona erecek şekilde ayarlanır. Arka ucun lease_expiration_time'ı değiştirmesine izin verilir (ör. istenen kiralama süresi aşırı uzunsa). Oluşturulan kiralama sözleşmesi müşteriye iade edilir. Daha sonra müşteri, kiralama için rezervasyon oluşturmak ister.

Kiralama işlemi oluşturma işlemi herhangi bir iş mantığı hatası nedeniyle başarısız olursa yanıtta bu hatanın doldurulması gerekir. Ayrıntılı bilgi için Rezervasyon Başarısızlığı bölümüne bakın.

İ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'ta ayarlanmalıdır.
  • Kaynak alanı CreateLeaseRequest'te belirtilmişse CreateLeaseResponse'ta ayarlanması ve CreateLeaseRequest ile eşleşmesi gerekir.
  • 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 slot süresi 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;
}