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

जब 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