पांचवां चरण: एपीआई से जुड़े रीयल-टाइम अपडेट

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

एपीआई के रीयल-टाइम अपडेट और फ़ीड

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

हालांकि, API अपडेट का इस्तेमाल ऐसी किसी भी जानकारी को अपडेट करने के लिए किया जा सकता है जो व्यापारियों और सेवाओं के बारे में जानकारी जैसे फ़ीड से मिल सकती है, का इस्तेमाल आम तौर पर, सिर्फ़ उपलब्धता की जानकारी को अपडेट करने के लिए किया जाता है.

रीयल-टाइम अपडेट के लिए ज़रूरी एपीआई

रीयल-टाइम अपडेट (आरटीयू) एपीआई
BookingNotification ज़रूरी किसी भी समय बुकिंग सूचना आरटीयू भेजें बुकिंग में कोई बदलाव हुआ हो. जैसे, बुकिंग में बदलाव करना या उसे रद्द करना.
उपलब्धता बदलने के लिए आरटीयू कुछ शर्तों के मुताबिक ज़रूरी है[1] इनमें से कोई एक भेजें बैच बदलना या सिंगल रिप्लेस वाले आरटीयू, इन्वेंट्री की उपलब्धता के बारे में अपडेट भेजने के लिए इस्तेमाल किए जाते हैं. बदलावों को लागू होने और दिखने में कुछ मिनट लग सकते हैं.
कारोबारी या कंपनी के लिए आरटीयू वैकल्पिक अगर आपको कारोबारी या कंपनी की जानकारी में बदलाव करना है, तो आरटीयू भेजें रीयल टाइम में जानकारी पाएँ. बदलावों को लागू होने में कई घंटे लग सकते हैं और आत्मचिंतन करें.
सेवा आरटीयू वैकल्पिक अगर आपको सेवा में बदलाव करना है, तो सेवा से जुड़े आरटीयू भेजें रीयल टाइम में जानकारी पाएँ. इसका इस्तेमाल आम तौर पर तब किया जाता है, जब सेवा की कीमत दिन के दौरान बहुत ज़्यादा उतार-चढ़ाव होता रहता है. इसलिए, सेवा आरटीयू लागू करना है इसका सुझाव दिया जाता है कि कीमत मेल न खाने की वजह से ऑर्डर पूरा न हो सके. बदलाव हो सकते हैं इन्हें लागू होने और इन पर काम करने में कई घंटे लगते हैं.

उपलब्धता बदलें एपीआई RTU

उपलब्धता के अपडेट देने के लिए, 'खरीदारी के लिए उपलब्धता बदलें' एपीआई का इस्तेमाल करें इस्तेमाल के ये उदाहरण:

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

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

बुकिंग की सूचना से जुड़ा एपीआई आरटीयू

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

Request:
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status

Body:
{"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"CANCELED"}

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

सेवा खाता बनाना

इन कामों के लिए Google API कंसोल में क्रेडेंशियल टैब का उपयोग करें सेवा खाता बनाएं. निजी कुंजी को JSON फ़ॉर्मैट में, किसी सुरक्षित जगह पर सेव करें जगह. खाता बनाते समय, आपके पास भूमिका सेट करने का विकल्प होता है "मालिक."

Maps बुकिंग एपीआई की पुष्टि करें

सेवा खाता बनाने के बाद, इन एपीआई की पुष्टि करें:

  • Google Maps बुकिंग एपीआई
  • Google Maps बुकिंग एपीआई (डेवलपर)

ऐसा करने के तरीके के बारे में सिलसिलेवार निर्देश पाने के लिए, Maps के लिए बुकिंग एपीआई की मदद से पुष्टि करना ट्यूटोरियल.

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

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

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

भाषा डाउनलोड करने का लिंक
Java Java क्लाइंट लाइब्रेरी. ज़्यादा जानकारी के लिए, देखें Java क्लाइंट के लिए निर्देश.

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

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

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

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

curl -s -o 'mapsbooking_rest' 'https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha'

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

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

एपीआई को कॉल करते समय, इन लेखों को पढ़ें आपकी सेवा को अनुमति देने के लिए, अनुमति वाला एपीआई कॉल करने की तैयारी की जा रही है अपने निजी पासकोड और निम्न OAuth दायरे के साथ खाते को लिंक करें: https://www.googleapis.com/auth/mapsbooking.

एपीआई कोटा

एपीआई अपडेट में,हर 60 सेकंड में 1, 500 अनुरोध या 25 अनुरोध होते हैं औसतन प्रति सेकंड. कोटा पार होने पर (ऐसा तब होता है जब आपने अपने पार्टनर पोर्टल में सही Google Cloud प्रोजेक्ट नंबर नहीं जोड़ा हो), तो Google गड़बड़ी का मैसेज दिख रहा है:

{
  "error": {
    "code": 429,
    "message": "Insufficient tokens for quota ...",
    "status": "RESOURCE_EXHAUSTED",
    "details": [...]
  }
}

इसे हैंडल करने के लिए, कॉल को बहुत बड़े अंतराल पर तब तक फिर से इस्तेमाल करके देखें, जब तक तो वह सफल हो जाता है. अगर कोटा को नियमित तौर पर खत्म करते हैं, तो ReplaceServiceAvailability, इस पर स्विच करें एपीआई की संख्या कम करने के लिए BatchReplaceServiceAvailabily कॉल. इस तरीके से, एक एपीआई में कई सेवाएं अपडेट की जा सकती हैं कॉल.

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

इसके ज़रिए, सैंडबॉक्स और प्रोडक्शन एनवायरमेंट, दोनों को कॉल किया जा सकता है एपीआई को चुनें. पक्का करें कि आपने 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()