जब Google, कीमत की जानकारी का अनुरोध
मैसेज भेजता है, तो आपके सर्वर को कीमत की जानकारी का जवाब मैसेज भेजना चाहिए. इसमें उन होटलों की जानकारी होनी चाहिए जिनकी कीमतों में बदलाव हुआ है. यह बदलाव, उन सर्वर से Google को पिछली बार कीमत की जानकारी का जवाब मिलने के बाद हुआ हो. अगर किराये में कोई बदलाव होता है, तो Google एक <Query> भेजता है. इससे, बताए गए होटलों और यात्रा की योजनाओं के लिए, किराये का अपडेट किया गया डेटा मिलता है.
कीमत बदलने की प्रोसेस के बारे में खास जानकारी के लिए, कीमत की खास जानकारी देखें.
जवाब में दिए गए सुझावों में, चुने गए होटलों और उनकी यात्रा योजनाओं की कीमत फिर से तय करने के लिए, इन तरीकों का इस्तेमाल किया जाता है:
हिंट रिस्पॉन्स मैसेज का रूट एलिमेंट <Hint> होता है. आपने एक या उससे ज़्यादा <Item> एलिमेंट का इस्तेमाल करके, होटल या यात्रा कार्यक्रम को अपडेट करने का अनुरोध किया हो. एक Hint
Response मैसेज में, <Item> एलिमेंट की कोई भी संख्या तय की जा सकती है.
हर जवाब के सुझाव वाले मैसेज में, हर <Item> के लिए कम से कम एक <Property> एलिमेंट होना चाहिए. <Property>, होटल की सूची में इस्तेमाल किए गए आईडी का इस्तेमाल करके, किसी होटल की पहचान करता है. डिफ़ॉल्ट रूप से, हर <Item> ब्लॉक के लिए एक होटल आईडी तय किया जाता है. हालांकि, अगर आपको फिर से कीमत तय करने के लिए, चेक-इन की तारीख की सीमा या ठहरने की अवधि की सीमा का इस्तेमाल करना है, तो Google को यह निर्देश दिया जा सकता है कि वह किसी आइटम ब्लॉक में एक से ज़्यादा होटल दिखाए.
यात्रा की योजना से जुड़े अनुरोध और जवाब का सटीक फ़्लो
सुझाव वाले मैसेज, अलग-अलग यात्रा योजनाओं के आधार पर दिखाए जा सकते हैं. जैसे, चेक-इन की तारीख और ठहरने की अवधि के कॉम्बिनेशन के आधार पर. इस मामले में, आपको अपने होटलों के लिए चेक-इन की तारीख और ठहरने की अवधि बतानी होती है. इसके बाद, Google सिर्फ़ उस यात्रा की योजना के लिए, किराये का नया डेटा फ़ेच करता है.
पार्टनर का जवाब
यहां दिए गए जवाब के मैसेज में, एक प्रॉपर्टी और एक यात्रा कार्यक्रम के बारे में बताया गया है:
<Hint>
<Item>
<Property>12345</Property>
<Stay>
<CheckInDate>2023-05-20</CheckInDate>
<LengthOfStay>3</LengthOfStay>
</Stay>
</Item>
</Hint>
Google का जवाब
Google, आपके 'जवाब के लिए हिंट' मैसेज का जवाब, <Query> के तौर पर देता है. यह जवाब इस तरह का हो सकता है:
<Query>
<Checkin>2023-05-20</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
<Transaction> बनाएं
इसके बाद, आपको होटल में ठहरने के लिए, किराये के अपडेट के साथ <Transaction> बनाना होगा.
5/20/23 - 5/23/23
चेक-इन करने की तारीख की सीमा के अनुरोध और जवाब का फ़्लो
सुझाव वाले जवाब के मैसेज में, चेक-इन करने की तारीखों की एक सीमा तय की जा सकती है. यह सीमा, चेक-इन करने की पहली तारीख से लेकर चेक-इन करने की आखिरी तारीख तक होती है. किराये का नया डेटा फ़ेच करते समय, Google होटल में चेक-इन करने की हर तारीख के लिए यात्रा की योजनाएं इकट्ठा करता है. ये योजनाएं, उन तारीखों से शुरू होती हैं और ठहरने की उस अवधि तक चलती हैं जिसके बारे में आपने बताया है.
पार्टनर की तय की गई तारीखों की सीमा
यहां दिए गए उदाहरण में, हिंट रिस्पॉन्स मैसेज के लिए एक प्रॉपर्टी तय की गई है. इसमें चेक-इन के लिए तारीख की सीमा दी गई है:
<Hint>
<Item>
<Property>12345</Property>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</Item>
</Hint>
Google का जवाब
Google, इस हिंट रिस्पॉन्स मैसेज का जवाब <Query> के साथ देता है. यह जवाब कुछ इस तरह का होता है:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<Nights>5</Nights>
<PropertyList>
<Property>12345</Property>
</PropertyList>
</Query>
<Transaction> बनाएं
इसके बाद, आपको उस होटल के लिए, इन तारीखों पर ठहरने के लिए <Transaction> बनाना होगा. इसमें किराये की अपडेट की गई जानकारी शामिल होनी चाहिए:
5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/20/23 - 5/24/23
5/20/23 - 5/25/23
5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/21/23 - 5/25/23
5/21/23 - 5/26/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/22/23 - 5/26/23
5/22/23 - 5/27/23
इस उदाहरण में, पांच रातों के लिए ठहरने की अवधि का इस्तेमाल किया गया है. डिफ़ॉल्ट रूप से, ठहरने की अवधि 30 दिन होती है.
तय सीमा में ठहरने के अनुरोध और जवाब का फ़्लो
'कीमत में बदलाव की सूचना' वाले मैसेज में, तारीखों की वह सीमा शामिल हो सकती है जिसमें बदलाव हुआ है. इससे Google को यह जानकारी मिलती है कि उसे उन तारीखों से जुड़ी किसी भी यात्रा की योजना को फ़ेच करना चाहिए. यात्रा की योजनाओं का कौनसा सेट फ़ेच किया जाएगा, यह इन दो बातों पर निर्भर करता है: तारीखों का कौनसा सेट बदला गया है और ठहरने की अवधि कितनी है.
पार्टनर के लिए, तय सीमा में ठहरने की सुविधा
यहां दिए गए हिंट रिस्पॉन्स मैसेज के उदाहरण में, रेंज के हिसाब से ठहरने की जानकारी का इस्तेमाल किया गया है:
<Hint>
<Item>
<Property>12345</Property>
<StaysIncludingRange>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</StaysIncludingRange>
</Item>
</Hint>
Google का जवाब
Google, आपके 'जवाब के लिए हिंट' मैसेज का जवाब, <Query> के तौर पर देता है. यह जवाब इस तरह का हो सकता है:
<Query>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>12345</Property>
<Property>67891</Property>
</PropertyList>
</Query>
<Transaction> बनाएं
इसके बाद, आपको होटल के लिए <Transaction> बनाना होगा. इसमें होटल के किराये की जानकारी अपडेट की गई हो. यह जानकारी इन तारीखों के लिए होनी चाहिए:
5/17/23 - 5/20/23
5/18/23 - 5/20/23
5/18/23 - 5/21/23
5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23
5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23