लीज़ पर अनुरोध किए गए स्लॉट का मालिकाना हक कुछ समय के लिए रहता है.
पार्टनर का बैकएंड इस बात की पुष्टि करता है कि अनुरोध किया गया अपॉइंटमेंट स्लॉट मान्य है और
फिर भी उपलब्ध है. अंदरूनी तौर पर, पार्टनर, अनुरोध किए गए स्लॉट के लिए अस्थायी शुल्क तय करता है. इसकी समयसीमा lease_expiration_time पर अपने-आप खत्म हो जाती है. बैकएंड को lease_expiration_time में बदलाव करने की अनुमति है. उदाहरण के लिए, अगर अनुरोध किया गया लीज़ टाइम बहुत ज़्यादा है.
बनाया गया लीज़ क्लाइंट को वापस कर दिया जाता है.
हमारा बुकिंग एपीआई, लीज़ के लिए वैकल्पिक सहायता उपलब्ध कराता है. लीज़ की सुविधा के साथ, अनुरोध किए गए स्लॉट के लिए लीज़ बनाना बुकिंग बनाने का पहला कदम है.
// 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;
}
लीज़ के बारे में ज़्यादा जानकारी
लीज़ की सहायता देना ज़रूरी नहीं है. यह उन पार्टनर पर लागू होता है जो सहायता लागू करने में दिलचस्पी रखते हैं. शुरू करने से पहले, ज़रूरी शर्तें पूरी करने के लिए कार्रवाई केंद्र से संपर्क करें.
लीज़ की सुविधा देने के लिए, एपीआई v2 के सुझाए गए सेट को लागू करना ज़रूरी है. इसके अलावा,
- CreateLease को लागू करना ज़रूरी है.
- CreateBooking लागू करना ज़रूरी है. साथ ही, इसके लिए लीज़ रेफ़रंस का इस्तेमाल करना ज़रूरी है. पार्टनर बैकएंड, दिए गए लीज़ रेफ़रंस का इस्तेमाल करके बुकिंग करता है.
एपीआई v2 की ज़रूरी शर्तें, लीज़ पर देने के लिए भी लागू होती हैं. इसके अलावा,
- CreateBooking लीज़ रेफ़रंस का इस्तेमाल कर सकती है. दिए गए लीज़ रेफ़रंस से बुकिंग करते समय, पार्टनर लीज़ का इस्तेमाल करता है और उसे आगे की किसी भी बुकिंग के लिए अमान्य माना जाता है. पार्टनर, अनुरोध के मैसेज में स्लॉट का इस्तेमाल करके बनाई गई बुकिंग की पुष्टि करने के लिए भी ज़िम्मेदार है.
- अतिरिक्त gRPC गड़बड़ी कोड के तौर पर, NOT_FOUND का इस्तेमाल तब किया जाता है, जब लीज़ का रेफ़रंस दिया जाता है. साथ ही, पार्टनर के पास लीज़ आईडी की जानकारी नहीं होती.
