जवाब के बारे में हिंट देने वाले मैसेज

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

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

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

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

हर हिंट रिस्पॉन्स मैसेज में, हर <Property> के लिए कम से कम एक <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 होटल में चेक-इन करने की हर तारीख के लिए यात्रा की योजनाएं इकट्ठा करता है. ये योजनाएं, उन तारीखों से शुरू होती हैं और ठहरने की उस अवधि तक चलती हैं जिसके बारे में आपने बताया है.

पार्टनर की ओर से तय की गई तारीखों की सीमा

यहां दिए गए उदाहरण में, हिंट रिस्पॉन्स मैसेज के लिए एक प्रॉपर्टी तय की गई है. इसमें चेक-इन के लिए तारीख की सीमा दी गई है:

<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