रीयल-टाइम अपडेट तैयार हैं

आपके सिस्टम में मौजूद इन्वेंट्री में बदलाव होता है. ऐसा नई बुकिंग, रद्द की गई बुकिंग, और कारोबारियों या कंपनियों के शेड्यूल में हुए बदलावों की वजह से होता है. रीयल-टाइम अपडेट (आरटीयू) एपीआई, Google को इन बदलावों के बारे में सूचना देने का एक तरीका है. साथ ही, यह मौजूदा बुकिंग में किए गए बदलावों के बारे में भी सूचना देता है.

इन मामलों में आरटीयू ज़रूरी होते हैं:

• जब कोई उपयोगकर्ता आपके सिस्टम पर बुकिंग रद्द करता है और स्लॉट उपलब्ध हो जाता है.
• जब कोई व्यक्ति Actions Center के ज़रिए रिज़र्वेशन करता है और वह स्लॉट अब उपलब्ध नहीं है.
• जब Actions Center के ज़रिए की गई बुकिंग को आपकी ओर से रद्द किया जाता है. उदाहरण के लिए, कारोबारी या कंपनी सीधे तौर पर बुकिंग रद्द कर सकती है. आपको बुकिंग और उपलब्धता की जानकारी अपडेट करनी होगी, क्योंकि ओरिजनल स्लॉट अब उपलब्ध है.

सैंडबॉक्स की समीक्षा पर जाने से पहले, आरटीयू के इस माइलस्टोन टास्क को पूरा करें:

• BookingNotification Ready

जब पिछले 14 दिनों में किए गए आखिरी 20 अनुरोधों में कोई गड़बड़ी नहीं होती है, तब हर टास्क को 'पूरा हो गया' के तौर पर मार्क कर दिया जाता है और वह हरे रंग का हो जाता है. यह पक्का करने के लिए कि माइलस्टोन हरा बना रहे, अनुरोध भेजते रहें.

एपीआई आरटीयू और फ़ीड

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

ज़्यादा जानकारी के लिए, यहां दिए गए संसाधन देखें:

• आरटीयू को स्ट्रक्चर करना

• RESTful कॉल का इस्तेमाल करने वाले आरटीयू के लिए Java क्लाइंट का उदाहरण

• इन्वेंट्री अपडेट करने वाला एपीआई

एपीआई ऐक्सेस करना

Google Cloud प्रोजेक्ट के ज़रिए, Actions Center के Maps Booking API को ऐक्सेस किया जाता है. इसी के ज़रिए, आरटीयू सबमिट किए जाते हैं. आपको Google Developers Console में Google खाते का इस्तेमाल करना होगा. साथ ही, ऑनबोर्डिंग प्लान के सेटअप माइलस्टोन में, अपना Cloud Project Number देना होगा. Cloud API चालू करने के तरीके के बारे में ज़्यादा जानने के लिए, Cloud API चालू करना लेख पढ़ें.

RESTful कॉल का इस्तेमाल करना या क्लाइंट लाइब्रेरी डाउनलोड करना

हमारा सुझाव है कि आप JSON पेलोड के साथ, Maps Booking API को सीधे तौर पर RESTful कॉल करें. ज़्यादा जानकारी के लिए, REST API से जुड़ा दस्तावेज़ देखें.

एपीआई से कनेक्ट करने के लिए, क्लाइंट लाइब्रेरी का भी इस्तेमाल किया जा सकता है.

ज़्यादा सपोर्ट लाइब्रेरी डाउनलोड की जा सकती हैं. ये लाइब्रेरी, Google API को कॉल करने के लिए अनुमति देने और अन्य पहलुओं को मैनेज करती हैं. ज़्यादा जानकारी के लिए, कोड के सैंपल देखें.

खोज से जुड़ा दस्तावेज़ फ़ेच करना

कुछ क्लाइंट लाइब्रेरी, जैसे कि Ruby के लिए, एपीआई का डिस्कवरी दस्तावेज़ फ़ेच करना ज़रूरी होता है. इसमें एपीआई के तरीकों और पैरामीटर के बारे में बताया गया होता है.

डिस्कवरी दस्तावेज़ पाने के लिए, इस कमांड का इस्तेमाल करें:

curl -s -o mapsbooking_rest

https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha

Ruby से एपीआई को ऐक्सेस करने के तरीके के बारे में ज़्यादा जानने के लिए, Ruby API Client और Ruby Auth Library देखें.

एपीआई को अनुमति वाले कॉल करना

एपीआई को कॉल करते समय, डेलिगेट किए गए एपीआई कॉल की तैयारी करना लेख पढ़ें. इससे आपको अपनी निजी कुंजी और OAuth के इस स्कोप की मदद से, सेवा खाते को अनुमति देने में मदद मिलेगी:

https://www.googleapis.com/auth/mapsbooking

सैंडबॉक्स और प्रोडक्शन एंडपॉइंट

एपीआई के ज़रिए, सैंडबॉक्स और प्रोडक्शन, दोनों एनवायरमेंट में कॉल किए जा सकते हैं. पक्का करें कि आपने अपने Google Cloud प्रोजेक्ट में दोनों एपीआई चालू किए हों. दोनों एपीआई एक ही स्कोप का इस्तेमाल करते हैं, लेकिन उनके एंडपॉइंट अलग-अलग होते हैं.

प्रोडक्शन एंडपॉइंट: https://mapsbooking.googleapis.com/

सैंडबॉक्स एंडपॉइंट: https://partnerdev-mapsbooking.googleapis.com/

यहां Java में एंडपॉइंट स्विच करने का एक उदाहरण दिया गया है:

 // This block of code is for OAuth and is the same for prod and sandbox.
    GoogleCredential
      .fromStream(new FileInputStream(...))
      .createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))

    // This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
    new GoogleMapsBookingAPI.Builder(...)
      .setApplicationName(...)
      .setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
      .build()