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

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

पार्टनर का बैकएंड यह पुष्टि करता है कि अपॉइंटमेंट के लिए अनुरोध किया गया स्लॉट मान्य है और अब भी उपलब्ध है. पार्टनर, अनुरोध किए गए स्लॉट के लिए कुछ समय के लिए होल्ड बनाता है. यह होल्ड, lease_expiration_time पर अपने-आप खत्म हो जाता है. बैकएंड को lease_expiration_time में बदलाव करने की अनुमति है. उदाहरण के लिए, अगर अनुरोध किया गया लीज़ का समय बहुत ज़्यादा है. बनाई गई लीज़ को क्लाइंट को वापस भेज दिया जाता है.

हमारा बुकिंग एपीआई, लीज़ के लिए सहायता उपलब्ध कराता है. हालांकि, यह सुविधा वैकल्पिक है. लीज़ की सुविधा के साथ, बुकिंग बनाते समय अनुरोध किए गए स्लॉट के लिए लीज़ बनाना पहला चरण होता है.

// Temporary lease for an inventory slot
message Lease {
  option features.(pb.java).nest_in_file_class = YES;

  // 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 {
  option features.(pb.java).nest_in_file_class = YES;

  // Lease ID (required)
  string lease_id = 1;
}

पट्टों के बारे में अतिरिक्त जानकारी

लीज़ की सुविधा ज़रूरी नहीं है. यह उन पार्टनर पर लागू होता है जो सहायता लागू करने में दिलचस्पी रखते हैं. शुरू करने से पहले, कृपया यह जानने के लिए कार्रवाई केंद्र से संपर्क करें कि आपका खाता ज़रूरी शर्तें पूरी करता है या नहीं.

लीज़ की सुविधा के लिए, एपीआई v2 का सुझाया गया सेट लागू करना होगा. इसके अलावा,

• CreateLease को लागू करना ज़रूरी है.
• CreateBooking को लागू करना ज़रूरी है. साथ ही, इसमें लीज़ के रेफ़रंस का इस्तेमाल करना चाहिए. पार्टनर का बैकएंड, दिए गए लीज़ रेफ़रंस का इस्तेमाल करके बुकिंग करता है.

लीज़ की सुविधा के लिए, एपीआई v2 की ज़रूरी शर्तें भी लागू होती हैं. इसके अलावा,

• CreateBooking को लीज़ के रेफ़रंस का इस्तेमाल करना चाहिए. बुकिंग करते समय, पार्टनर दिए गए लीज़ रेफ़रंस का इस्तेमाल करता है. इससे लीज़ का इस्तेमाल हो जाता है और आगे की बुकिंग के लिए, यह अमान्य हो जाता है. अनुरोध वाले मैसेज में मौजूद स्लॉट का इस्तेमाल करके, बनाई गई बुकिंग की पुष्टि करने की ज़िम्मेदारी भी पार्टनर की होती है.
• अगर पट्टे का रेफ़रंस दिया गया है और पार्टनर को पट्टे के आईडी के बारे में जानकारी नहीं है, तो NOT_FOUND का इस्तेमाल gRPC के अतिरिक्त गड़बड़ी कोड के तौर पर किया जाता है.

आंकड़ा: लीज़ के लिए बुकिंग करना