Lease sementara waktu menangguhkan kepemilikan Slot yang diminta.
Backend partner memverifikasi bahwa slot janji temu yang diminta valid dan masih tersedia. Secara internal, partner membuat penangguhan sementara atas Slot yang diminta, yang disiapkan untuk berakhir secara otomatis pada lease_expiration_time. Backend diizinkan mengubah lease_expiration_time, mis., jika waktu lease yang diminta terlalu panjang.
Lease yang dibuat ditampilkan ke klien.
Booking API kami menyediakan dukungan opsional untuk Lease. Dengan dukungan lease, membuat Lease untuk Slot yang diminta adalah langkah pertama saat membuat Pemesanan.
// 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;
}
Informasi tambahan tentang lease
Dukungan untuk lease bersifat opsional. Hal ini berlaku untuk partner yang berminat untuk menerapkan dukungan tersebut. Hubungi Pusat Tindakan untuk menentukan kelayakan sebelum Anda memulai.
Untuk mendukung lease, kumpulan API v2 yang direkomendasikan harus diterapkan; selain itu,
- CreateLease harus diterapkan.
- CreateBooking harus diterapkan dan diharapkan menggunakan referensi lease. Backend partner melakukan pemesanan dengan referensi lease yang disediakan.
Persyaratan API v2 juga berlaku untuk dukungan lease; selain itu,
- CreateBooking diharapkan menggunakan referensi lease. Saat melakukan pemesanan dengan referensi lease yang disediakan, partner menggunakan lease tersebut dan membuatnya tidak valid untuk pemesanan lainnya. Partner juga bertanggung jawab untuk memverifikasi pemesanan yang dibuat menggunakan slot dalam pesan permintaan.
- Sebagai kode error gRPC tambahan, NOT_FOUND digunakan jika referensi lease diberikan dan ID lease tidak diketahui oleh partner.
