हिंट रिस्पॉन्स मैसेज

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

कीमत में बदलाव करने की प्रोसेस के बारे में खास जानकारी पाने के लिए, कीमत की खास जानकारी देखें.

चुने गए होटलों और उनकी यात्रा की योजनाओं की कीमत फिर से तय करने के लिए, हिंट रिस्पॉन्स मैसेज इन तरीकों का इस्तेमाल करते हैं:

हिंट रिस्पॉन्स मैसेज का रूट एलिमेंट <Hint> होता है. एक या उससे ज़्यादा <Item> एलिमेंट का इस्तेमाल करके, होटल या यात्रा की योजना को अपडेट करने का अनुरोध किया जाता है. एक ही हिंट रिस्पॉन्स मैसेज में, <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