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

जब 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, किराये का नया डेटा फ़ेच करता है, तो 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

इस उदाहरण में, ठहरने की डिफ़ॉल्ट अवधि पांच रातों का इस्तेमाल किया गया है.

तय समय के हिसाब से अनुरोध और रिस्पॉन्स का फ़्लो

हिंट रिस्पॉन्स मैसेज में उन तारीखों की रेंज शामिल हो सकती है जिनमें बदलाव हुआ है. इससे 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