लीज़ की खास बातें

लीज़ की मदद से, अनुरोध किए गए स्लॉट का मालिकाना हक कुछ समय के लिए मिल जाता है.

पार्टनर का बैकएंड यह पुष्टि करता है कि अनुरोध किया गया अपॉइंटमेंट स्लॉट मान्य है और अब भी उपलब्ध है. पार्टनर, अनुरोध किए गए स्लॉट को कुछ समय के लिए होल्ड कर देता है. यह स्लॉट 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 का इस्तेमाल किया जाता है.
इमेज: लीज़ के लिए बुकिंग करना