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

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

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

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

हिंट रिस्पॉन्स मैसेज का रूट एलिमेंट <Hint> है. आपने किसी होटल का अनुरोध किया है या एक या ज़्यादा <Item> एलिमेंट का इस्तेमाल करके, यात्रा की योजना अपडेट की जानी है. एक संकेत रिस्पॉन्स मैसेज में, <Item> एलिमेंट की संख्या के बारे में बताया जा सकता है.

हिंट रिस्पॉन्स मैसेज में कम से कम एक <Property> एलिमेंट होना चाहिए हर <Item>. <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