Java बुकिंग एपीआई क्लाइंट

रीयल-टाइम अपडेट लागू करने के लिए, आप हमारे Java रीयल-टाइम अपडेट एपीआई क्लाइंट को डाउनलोड कर सकते हैं.

पूर्वापेक्षा:

अपना सेवा खाता बनाने के लिए, अपनी निजी कुंजी डाउनलोड करें.

शुरू करें:

1. ‘Java फ़ाइलों’ का पैकेज डाउनलोड करने के लिए, Java क्लाइंट लाइब्रेरी फ़ाइल डाउनलोड करें.

2. अपने आईडीई में एक Java प्रोजेक्ट बनाएं. इसके लिए, इस रेपो से InventoryUpdate.java और BookingNotification.java के सैंपल कोड डाउनलोड करें:

   git clone https://maps-booking.googlesource.com/java-maps-booking-api-example
   

   और उन्हें अपने Java प्रोजेक्ट में src डायरेक्ट्री में इंपोर्ट करें.

3. निजी डायरेक्ट्री (JSON फ़ाइल) की कॉपी src डायरेक्ट्री में बनाएं.
4. अपने प्रोजेक्ट की डिपेंडेंसी में Java क्लाइंट लाइब्रेरी जोड़ें (मैपबुक और लाइब्रेरी सोर्स की डायरेक्ट्री में जार फ़ाइलें शामिल करें).
5. दोनों Java फ़ाइलों में, अपने काम पूरे करने के लिए TODO का पालन करें

REST API के बारे में ज़्यादा जानकारी यहां देखी जा सकती है.

समस्या का हल:

1. मौजूदा MerchantId या ServiceId का इस्तेमाल करके, कोई नया व्यापारी/सेवा बनाने की कोशिश करने पर आपको गड़बड़ी का यह मैसेज दिखेगा:

   409 Conflict
   {
     “code” : 409,
     “errors” :
       [{
           “domain” : “global”,
           “message” : “Requested entity already exists”,
           “reason” : “alreadyExists”,
           “debugInfo” : “detail: "[ORIGINAL ERROR] generic::already_exists: ...”\n"
       }],
     “message” : “Requested entity already exists”,
     “status” : “ALREADY_EXISTS”
   }
   

2. किसी गलत मर्चेंट आईडी या ServiceId का इस्तेमाल करते समय, कॉल करने के दौरान कोई गड़बड़ी का मैसेज नहीं आएगा. ऐसा इसलिए होता है, क्योंकि RTU की मदद से उपलब्धता स्लॉट में किए जाने वाले बदलाव, ऑर्डर में किए जा सकने वाले आउट-ऑफ़-ऑर्डर के साथ काम करते हैं. इसलिए, इन्हें मर्चेंट आईडी या ServiceId से नहीं जोड़ा जाता. हालांकि, अनुरोध में दिए गए स्लॉट, मर्चेंट या आईडी अमान्य होने की वजह से प्रोडक्शन में नहीं दिखाए जाएंगे. इन स्लॉट को क्रॉल करने लायक बनाने के लिए, आरटीयू या फ़ीड का इस्तेमाल करके, व्यापारी/कंपनी या सेवा की जानकारी जोड़ें.
3. सभी अपडेट फ़ंक्शन में, अपडेट करने के लिए फ़ील्ड तय करने के लिए, पैरामीटर ‘updateMask’ FieldMask फ़ॉर्मैट में होना चाहिए. एपीआई के लिए सिर्फ़ फ़ील्ड में डाली गई वैल्यू को बदलना ज़रूरी होता है, जैसा कि मास्क में बताया गया है. साथ ही, इससे दूसरों को कोई कार्रवाई नहीं मिलती. अगर आप गलत updateMask स्ट्रिंग पास करते हैं, तो अपडेट लागू नहीं होगा. अगर अपडेट के समय फ़ील्ड मास्क मौजूद नहीं है, तो कार्रवाई सभी फ़ील्ड पर लागू होती है (जैसे कि सभी फ़ील्ड का फ़ील्ड मास्क दिया गया है). इसलिए, अगर आप सभी फ़ील्ड अपडेट करना चाहते हैं, तो updateMask को खाली पर सेट करें.
4. जवाब में शून्य फ़ील्ड वाला कोई भी फ़ील्ड नहीं दिखाया जाता.