इस पेज का अनुवाद Cloud Translation API से किया गया है.

क्वेरी & हिंट एक्सएमएल रेफ़रंस

इस सेक्शन में, Google एक्सएमएल पर आधारित हिंट रिक्वेस्ट मैसेज, सुझाव के मैसेज, और क्वेरी मैसेज के लिए रेफ़रंस दिया गया है.

`<Hint>` (हिंट रिस्पॉन्स मैसेज)

हिंट रिस्पॉन्स मैसेज का रूट एलिमेंट. हिंट रिस्पॉन्स मैसेज से यह पता चलता है कि होटल/यात्रा की योजना के किन कॉम्बिनेशन के लिए फिर से शुल्क लिया जाना चाहिए. ये Google से मिले सुझाव वाले मैसेज का आपका जवाब हैं.

हिंट रिस्पॉन्स मैसेज में सिर्फ़ उन होटलों के बारे में बताया जाना चाहिए जिनके किराये में बदलाव हुआ है. ऐसा उन होटलों के बारे में होना चाहिए जिनके किराये में पिछली बार Google को आपके सर्वर से हिंट रिस्पॉन्स मिलने के बाद से बदलाव हुआ था.

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

यात्रा की सटीक जानकारी: चेक इन करने की तारीख और ठहरने की कुल अवधि का कॉम्बिनेशन.
चेक-इन करने की तारीख की सीमाएं: यह चेक इन करने की तारीखों की सीमा के बारे में बताता है. यह पहले चेक इन करने की तारीख से शुरू होता है और चेक इन करने की आखिरी तारीख से खत्म होता है.
तय समय के लिए ठहरने की सुविधा (या तय की गई यात्रा की योजनाएं)

इनमें से हर तरीके के लिए, हिंट रिस्पॉन्स मैसेज के लिए एक अलग सिंटैक्स की ज़रूरत होती है.

ज़्यादा जानकारी के लिए, सुझाव वाले मैसेज देखें.

सिंटैक्स

संकेत वाले जवाब के मैसेज के टाइप के आधार पर, <Hint> एलिमेंट में अलग सिंटैक्स का इस्तेमाल किया जाता है:

सटीक यात्रा योजनाएं

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

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>hotel_ID</Property>
    ...
    <Stay>
      <CheckInDate>checkin_date</CheckInDate>
      <LengthOfStay>number_of_nights</LengthOfStay>
    </Stay>
  </Item>
  ...
</Hint>

चेक-इन रेंज

हिंट रिस्पॉन्स मैसेज में चेक-इन रेंज का सिंटैक्स नीचे दिखाया गया है:

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <!-- Can be > 1 if MultipleItineraries is "checkin_range" in your
         QueryControl message -->
    <Property>hotel_ID</Property>
    [...]

    <!-- Required -->
    <FirstDate>first_checkin_date</FirstDate>
    <!-- Required -->
    <LastDate>last_checkin_date</LastDate>
  </Item>
  ...
</Hint>

ठहरने की कुछ जगहें

संकेत वाले जवाब के मैसेज में, रेंज की गई सेल के लिए सिंटैक्स नीचे दिया गया है:

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <!-- Can be > 1 if MultipleItineraries is "affected_dates" in your
         QueryControl message -->
    <Property>hotel_ID</Property>
    [...]

    <StaysIncludingRange>
      <!-- Required -->
      <FirstDate>first_date</FirstDate>

      <!-- Optional -->
      <LastDate>last_date</LastDate>
    </StaysIncludingRange>
  </Item>
  ...
</Hint>

विशेषताएं

<Hint> एलिमेंट में यह एट्रिब्यूट शामिल होना ज़रूरी नहीं है: id. अगर दिया गया हो, तो इसे <Hint> के आधार पर भेजे गए <Query> मैसेज में, hintId एट्रिब्यूट के तौर पर शामिल किया जाता है.

चाइल्ड एलीमेंट

<Hint> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

चाइल्ड एलिमेंट	ज़रूरी है?	टाइप	हिंट रिस्पॉन्स टाइप	कंपनी का ब्यौरा
<CheckInDate>	Required	Date	सटीक यात्रा योजनाएं	यात्रा की योजना के लिए चेक इन करने की तारीख.
<FirstDate>	Required	Date	चेक-इन रेंज और अलग-अलग यात्रा की योजनाएं	चेक इन करने की सीमा या तय की गई तारीख की सीमा की पहली तारीख, संकेत वाले मैसेज के तौर पर सेट रहने की तारीख. तारीखें शामिल हैं.
<Item>	Required	Object	सभी	होटल/यात्रा की योजना के लिए कंटेनर अपडेट किया जाएगा.
<LastDate>	Required*	Date	चेक-इन रेंज और अलग-अलग यात्रा की योजनाएं	चेक इन करने की सीमा या तय की गई तारीख की सीमा के लिए आखिरी तारीख, हिंट रिस्पॉन्स मैसेज में बनी रहती है. तारीखें शामिल हैं. * तय की गई अवधि में ठहरने के दौरान, इस एलिमेंट का इस्तेमाल करना ज़रूरी नहीं है.
<LengthOfStay>	Required	integer	सटीक यात्रा की योजना	यात्रा की योजना के लिए रातों की संख्या, जिसे एक धनात्मक पूर्णांक के तौर पर दिखाया जाता है.
<Property>	Required	string	सभी	होटल की सूची के आईडी का इस्तेमाल करने वाले होटल का आईडी. `<Property>` एलिमेंट की संख्या, एक `<Item>` ब्लॉक में तय की जा सकती है. यह इस बात से तय होती है कि संकेत वाले रिस्पॉन्स वाले मैसेज किस तरह के हैं: सटीक यात्रा की योजना: ज़्यादा से ज़्यादा 100 होटल. चेक-इन रेंज: एक से ज़्यादा. अगर आपने `<QueryControl>` मैसेज में `<MultipleItineraries>` को `"checkin_range"` पर सेट किया है. तय समय: एक से ज़्यादा. अगर आपने `<QueryControl>` मैसेज में `<MultipleItineraries>` को `"affected_dates"` पर सेट किया है.
<Stay>	Required	Object	सटीक यात्रा योजनाएं	सटीक यात्रा योजना के संकेत वाले मैसेज में `<CheckinDate>` और `<LengthOfStay>` एलिमेंट के लिए कंटेनर. हर `<Item>` में सिर्फ़ एक `<Stay>` हो सकता है.
<StaysIncludingRange>	Required	Object	यात्रा की अलग-अलग योजनाएं	`<FirstDate>` और `<LastDate>` एलिमेंट के लिए एक कंटेनर, जो रेंज में मौजूद रहने के संकेत वाले मैसेज में मौजूद है.

उदाहरण

सटीक यात्रा योजनाएं

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

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>4</LengthOfStay>
    </Stay>
  </Item>
</Hint>

चेक-इन रेंज

इस उदाहरण में दो होटल के बारे में बताया गया है. इन होटलों के किराये में बदलाव हुआ है और इन्हें फिर से फ़ेच किया जाना चाहिए. Google को 3 जुलाई से 6 जुलाई के बीच प्रॉपर्टी 12345 और 67890 के लिए, यात्रा की सभी जानकारी मिलती है:

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Property>67890</Property>
    <FirstDate>2018-07-03</FirstDate>
    <LastDate>2018-07-06</LastDate>
  </Item>
</Hint>

ध्यान दें कि अगर आपको चेक-इन रेंज मैसेज की मदद से एक <Item> में कई प्रॉपर्टी दिखानी हैं, तो <QueryControl> में <MultipleItineraries> की वैल्यू को"checkin_range" पर सेट होना ज़रूरी है.

ठहरने की कुछ जगहें

इस उदाहरण में, अलग-अलग समय में ठहरने के दो अलग-अलग तरीके बताए गए हैं. एक कमरे में कई रातों के लिए और दूसरा एक रात के लिए इस्तेमाल किया जाता है:

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <!-- Google fetches prices for all itineraries (first and last date are set) -->
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
      <LastDate>2018-07-06</LastDate>
    </StaysIncludingRange>
  </Item>

  <!-- Google fetches prices for a single night (first date only) -->
  <Item>
    <Property>67890</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
    </StaysIncludingRange>
  </Item>
</Hint>

ध्यान दें कि किसी रेंज में ठहरने के मैसेज से एक ही <Item> में कई प्रॉपर्टी के बारे में बताने के लिए, <QueryControl> में <MultipleItineraries> की वैल्यू "affected_dates" पर सेट होनी चाहिए.

इनमें से हर उदाहरण के लिए, Google एक <Query> के साथ जवाब देता है. इसके बाद, आपको एक <Transaction> के साथ जवाब देना चाहिए, जिसमें बताए गए होटल/यात्रा शुरू करने की कंपनियों के किराये से जुड़े अपडेट शामिल हों.

`<HintRequest>`

हिंट रिक्वेस्ट मैसेज का रूट एलिमेंट. Google आपके सर्वर को सुझाव के लिए अनुरोध वाला मैसेज भेजता है. साथ ही, उसे एक ऐसे रिस्पॉन्स की उम्मीद होती है जिसमें उन होटल और यात्रा की योजना के बारे में बताया जाता है जिनकी कीमतों में पिछली बार Google को आपके सर्वर से संकेत वाला जवाब मिलने के बाद से बदलाव हुआ है.

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

ज़्यादा जानकारी के लिए, हिंट रिक्वेस्ट मैसेज देखें.

सिंटैक्स

<HintRequest> एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:

सिंटैक्स

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest>
  <LastFetchTime>last_fetch_time</LastFetchTime>
</HintRequest>

विशेषताएं

<HintRequest> एलिमेंट में कोई एट्रिब्यूट नहीं है.

चाइल्ड एलीमेंट

<HintRequest> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

चाइल्ड एलिमेंट	टाइप	कंपनी का ब्यौरा
<LastFetchTime>	DateTime	वह तारीख, जब Google को पिछली बार हिंट रिक्वेस्ट वाले मैसेज पर हिंट रिस्पॉन्स मैसेज मिला था. अगर यह समय, आपके सर्वर पर पिछली बार कीमतों को अपडेट किए जाने के समय से पहले का है, तो आपको हिंट रिस्पॉन्स मैसेज के साथ जवाब देना चाहिए, जिसमें यह बताया गया हो कि किन होटलों में बदलाव हुआ है. अगर हाल ही में कोई फ़ेच नहीं हुआ है, तो इसे तय इंटरवल वैल्यू पर सेट कर दिया जाएगा. इससे, बड़े बैकलॉग वाली गंभीर समस्याओं से बचने में मदद मिलेगी. इंटरवल की मौजूदा वैल्यू 1,000 सेकंड है, लेकिन इसमें बदलाव हो सकता है. ज़्यादा जानकारी के लिए, हिंट रिस्पॉन्स मैसेज देखें.

चाइल्ड एलिमेंट

टाइप

कंपनी का ब्यौरा

DateTime

वह तारीख, जब Google को पिछली बार हिंट रिक्वेस्ट वाले मैसेज पर हिंट रिस्पॉन्स मैसेज मिला था.

अगर यह समय, आपके सर्वर पर पिछली बार कीमतों को अपडेट किए जाने के समय से पहले का है, तो आपको हिंट रिस्पॉन्स मैसेज के साथ जवाब देना चाहिए, जिसमें यह बताया गया हो कि किन होटलों में बदलाव हुआ है.

अगर हाल ही में कोई फ़ेच नहीं हुआ है, तो इसे तय इंटरवल वैल्यू पर सेट कर दिया जाएगा. इससे, बड़े बैकलॉग वाली गंभीर समस्याओं से बचने में मदद मिलेगी. इंटरवल की मौजूदा वैल्यू 1,000 सेकंड है, लेकिन इसमें बदलाव हो सकता है.

ज़्यादा जानकारी के लिए, हिंट रिस्पॉन्स मैसेज देखें.

उदाहरण

इस उदाहरण में, सुझाव के लिए अनुरोध वाला मैसेज दिखाया गया है:

हिंट रिक्वेस्ट मैसेज

इस उदाहरण में, संकेत के लिए अनुरोध वाला मैसेज दिखाया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest id="ABCDEF" timestamp="2018-06-07T16:20:00Z">
  <LastFetchTime>2018-03-25T00:04:09Z</LastFetchTime>
</HintRequest>

`<Query>`

Query मैसेज का रूट एलिमेंट. Query मैसेज, Google से कीमत या मेटाडेटा के अपडेट के लिए किए गए अनुरोध होते हैं. इनका इस्तेमाल, पुल करने और बदली गई कीमत के डिलीवरी मोड, दोनों के साथ किया जाता है.

Query मैसेज तीन तरह के होते हैं:

मौजूदा कीमत: Google, उपयोगकर्ता के किसी खास अनुरोध का जवाब देता है और रीयल-टाइम में कीमत अपडेट करने के लिए कहता है. जब पार्टनर को Live pricing query मैसेज मिलता है, तो पार्टनर को <Transaction> मैसेज के साथ जवाब देना चाहिए. इस मैसेज में <Result> एलिमेंट में अनुरोध की गई कीमत की जानकारी शामिल होनी चाहिए.

अहम जानकारी: खोज के नए तरीके की वजह से, लाइव क्वेरी की सुविधा अब ईईए में मौजूद उपयोगकर्ताओं के लिए उपलब्ध नहीं है.
कॉन्टेक्स्ट के हिसाब से कीमत तय करने की सुविधा के साथ: Google, किराये की कैश मेमोरी को उन कॉन्टेक्स्ट के हिसाब से अपडेट करता है जो अब तक लोकप्रिय हैं. जब आपको With context query मैसेज मिलता है, तो आपको <Transaction> मैसेज के साथ जवाब देना चाहिए. इस मैसेज में <Result> एलिमेंट में अनुरोध की गई कीमत की जानकारी होनी चाहिए.
मेटाडेटा: Google, चुनिंदा होटलों के लिए कमरों और रूम बंडल के मेटाडेटा अपडेट का अनुरोध करता है. जब आपको Metadata Query मैसेज मिलता है, तो आपको <Transaction> मैसेज के साथ जवाब देना चाहिए. इस मैसेज में <PropertyDataSet> एलिमेंट में कमरों और कमरों के बंडल का डेटा दिया गया है.

ज़्यादा जानकारी के लिए, कीमत से जुड़ी क्वेरी के लिए कीमत की खास जानकारी और मेटाडेटा से जुड़ी क्वेरी के लिए रूम बंडल मेटाडेटा देखें.

तीन अलग-अलग टाइप के सिंटैक्स की जानकारी नीचे दी गई है.

सिंटैक्स

<Query> एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:

मौजूदा कीमत

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyList>
    <Property>hotel_id</Property>
    ...
  </PropertyList>
  <!-- See documentation below for <Context> -->
  <Context>
   ...
  </Context>
</Query>

कॉन्टेक्स्ट के साथ

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyContextList>
    <PropertyContext>
      <Property>hotel_id</Property>
      ...
      <!-- See documentation below for <Context> -->
      <Context>
      ...
      </Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

मेटाडेटा

<HotelInfoProperties>
  <Property>property_ID</Property>
  ...
</HotelInfoProperties>

विशेषताएं

<Query> एलिमेंट में एक एट्रिब्यूट हो सकता है: latencySensitive.

latencySensitive एट्रिब्यूट ज़रूरी नहीं है. अगर क्वेरी को true पर सेट किया जाता है, तो इससे पता चलता है कि क्वेरी Live Pricing Query है. अगर आप चाहते हैं कि Google, latencySensitive एट्रिब्यूट का इस्तेमाल करके क्वेरी भेजे, तो कृपया अपने तकनीकी खाता मैनेजर (टीएएम) से संपर्क करें.

चाइल्ड एलीमेंट

<Query> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

चाइल्ड एलिमेंट	क्वेरी का टाइप	टाइप	कंपनी का ब्यौरा
<AffectedNights>	Pricing	integer	ठहरने की कुल अवधि के हिसाब से रातों की संख्या. इस एलिमेंट का इस्तेमाल, सिर्फ़ तय की गई कीमत वाली क्वेरी के लिए किया जाता है. यह क्वेरी, किराये और उपलब्धता में बदलाव के साथ इस्तेमाल की जाती है.
<Checkin>	Pricing	Date	किसी खास कीमत में बदलाव होने की तारीखें.
<Context>	Pricing (Live Pricing Queries only)	<Context>	लाइव कीमत वाली क्वेरी के लिए, ऐसे कुछ पैरामीटर तय करता है जिनके तहत क्वेरी की जाती है. चाइल्ड एलिमेंट में ये शामिल हैं: `<Occupancy>`: मेहमानों की कुल संख्या `<OccupancyDetails>`: मेहमान किस तरह के हैं, जैसे कि वयस्क या बच्चे `<UserCountry>`: वह देश जहां उपयोगकर्ता मौजूद है `<UserDevice>`: डिवाइस का वह टाइप जिसका इस्तेमाल मेहमान होटल खोजने के लिए करता है, जैसे कि `"mobile`,"`tablet` ," या "`desktop`." `<Context>` एलिमेंट को एक ही अनुरोध में दोहराया जा सकता है. इससे अलग-अलग व्यस्तता के लिए क्वेरी की जा सकती हैं. चाइल्ड एलिमेंट, सिंटैक्स, और उदाहरणों की सूची के लिए `<Context>` से सलाह लें.
<FirstDate>	Pricing	Date	यात्रा की अलग-अलग योजनाओं के शुरू होने की तारीख, जिस पर किराया लागू होता है. इस एलिमेंट का इस्तेमाल सिर्फ़ चेक-इन तारीख की सीमा वाली कीमत से जुड़ी क्वेरी के लिए किया जाता है. यह क्वेरी, बदली हुई कीमत के साथ इस्तेमाल की जाती है.
<HotelInfoProperties>	Metadata	string	एक या एक से ज़्यादा ऐसी प्रॉपर्टी जिनके लिए, Google को अपडेट किए गए कमरे और रूम बंडल का मेटाडेटा, `Query` मैसेज के मेटाडेटा में चाहिए. इस एलिमेंट में एक या एक से ज़्यादा ऐसे `<Property>` एलिमेंट हो सकते हैं जिनसे होटल प्रॉपर्टी के आईडी की जानकारी मिलती हो.
<LastDate>	Pricing	Date	यात्रा की अलग-अलग अवधि के खत्म होने की तारीख, जिस पर किराया लागू होता है. इस एलिमेंट का इस्तेमाल सिर्फ़ चेक-इन की तारीख की सीमा वाली कीमत से जुड़ी क्वेरी के लिए किया जाता है. इन क्वेरी के लिए पुल + हिंट का इस्तेमाल किया जाता है.
<Nights>	Pricing	integer	किसी खास यात्रा की योजना के लिए रातों की संख्या, ज़्यादा से ज़्यादा 30.
<PropertyList>	Pricing	Object	होटल के एक या एक से ज़्यादा आईडी, जिनके लिए किराये में बदलाव करना ज़रूरी है. `<Property>` एलिमेंट में हर होटल के बारे में जानकारी दें. वैल्यू एक ऐसी स्ट्रिंग होती है जो आपकी होटल सूची में मौजूद होटल आईडी से मेल खाती है. उदाहरण के लिए: <PropertyList> <Property>pid1</Property> <Property>pid2</Property> </PropertyList>

उदाहरण

कीमत से जुड़ी क्वेरी

नीचे दिए गए उदाहरण में कीमत से जुड़ी क्वेरी का मैसेज दिखाया गया है. इसमें होटल के एक सेट के किराये में बदलाव करने का अनुरोध किया गया है. यह अपडेट तीन रातों के लिए उपलब्ध है और 10 जून, 2018 से शुरू होगा:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

मौजूदा किराये से जुड़ी क्वेरी

नीचे दिए गए उदाहरण में, लाइव कीमत तय करने से जुड़ी क्वेरी दिखाई गई है, जिसके जवाब के लिए 500 मिलीसेकंड की सीमा तय की गई है:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="8"/>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

कॉन्टेक्स्ट क्वेरी के साथ

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, occupancy and device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

मेटाडेटा क्वेरी

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

कुछ और उदाहरणों के लिए, ठहरने की तय की गई सीमा और चेक इन करने की तारीख की सीमा से जुड़ी क्वेरी के लिए, Query मैसेज के उदाहरण देखें.

`<Context>`

<Context> एलिमेंट, Live pricing query से जुड़ी जानकारी के बारे में बताता है. इसमें मेहमानों की संख्या और टाइप, उपयोगकर्ता के देश, और उपयोगकर्ता के डिवाइस की जानकारी शामिल होती है.

एक से ज़्यादा <Context> का इस्तेमाल, उपयोगकर्ता के अलग-अलग देशों या डिवाइसों के लिए कभी नहीं किया जाएगा. अगर एक से ज़्यादा <Context> का इस्तेमाल, एक से ज़्यादा बुकिंग के लिए क्वेरी करने के लिए किया जाता है, तो कृपया इससे जुड़ी प्रॉपर्टी/यात्रा की योजना के लिए, हर बुकिंग की कीमत को अलग से कमरे के बंडल के तौर पर बताएं. हर प्रॉपर्टी/यात्रा की योजना के लिए एक <Result> ब्लॉक होना चाहिए, जिसमें एक से ज़्यादा व्यस्त दिनों की कीमत शामिल होनी चाहिए.

<Context> क्वेरी के जवाब की जानकारी के लिए, <OccupancyDetails> देखें.

सिंटैक्स

<Context> एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:

सिंटैक्स

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>date</Checkin>
  <Nights>number_of_nights</Nights>
  <DeadlineMs>number_of_milliseconds</DeadlineMs>
  <PropertyList>
    <Property>property_ID</Property>
  </PropertyList>
  <Context>
  <Occupancy>total_number_of_guests</Occupancy>
  <OccupancyDetails>
    <NumAdults>number_of_adults</NumAdults>
    <Children>
      <Child age=age_of_one_child_guest/>
      <Child age=age_of_one_child_guest/>
    </Children>
  </OccupancyDetails>
  <UserCountry>end_user_country</UserCountry>
  <UserDevice>user_device_type</UserDevice>
  </Context>
</Query>

चाइल्ड एलीमेंट

<Context> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

चाइल्ड एलिमेंट	क्वेरी का टाइप	टाइप	कंपनी का ब्यौरा
<Occupancy>	Pricing	integer	इससे मेहमानों की कुल संख्या का पता चलता है. हालांकि, यह ज़रूरी नहीं है, लेकिन `<Occupancy>` वाली क्वेरी के नतीजे में `<Occupancy>` से जुड़ी हर क्वेरी के लिए, सही रूम बंडल के साथ लेन-देन का मैसेज मिलना चाहिए. ध्यान दें: ऐसा हो सकता है कि `<Occupancy>` हमेशा किसी क्वेरी में न दिखे. ऐसे मामलों में, आपको सभी बुकिंग के हिसाब से किराया दिखना चाहिए.
<OccupancyDetails>	Pricing	Object	इससे पहले `<Occupancy>` है. मेहमानों के बारे में उनके टाइप के हिसाब से बताता है. इनमें ये शामिल हैं: `<NumAdults>`: वयस्क मेहमानों की संख्या `<Children>` और `<Child="age">`: इससे पता चलता है कि कौनसे मेहमान बच्चे हैं (आम तौर पर, जिनकी उम्र 0 से 17 साल होती है). साथ ही, इसमें हर बच्चे की उम्र की जानकारी भी शामिल होती है. हालांकि, यह ज़रूरी नहीं है, लेकिन `<OccupancyDetails>` वाली क्वेरी के नतीजे में, `<Occupancy>` के लिए की गई हर क्वेरी के लिए, सही रूम बंडल के साथ लेन-देन का मैसेज भेजा जाना चाहिए. ध्यान दें: ऐसा हो सकता है कि `<OccupancyDetails>` हमेशा किसी क्वेरी में न दिखे. ऐसे मामलों में, आपको यह मान लेना चाहिए कि सभी मेहमान वयस्क हैं.
<UserCountry>	Pricing	string	उपयोगकर्ता जिस देश में है उसके हिसाब से दरों को फ़िल्टर करता है. यह वैल्यू दो अक्षरों वाला देश का कोड हो सकती है, जैसे कि अमेरिका के लिए `“US”` या क्षेत्र का कोड जैसे “यूरोप” के लिए `"EU"`. `<UserCountry>` तय की गई क्वेरी के नतीजे के तौर पर, लेन-देन से जुड़ा एक मैसेज दिखना चाहिए. साथ ही, जिस देश के लिए क्वेरी की गई है उसके लिए सही `<Rates>` ब्लॉक तय करना चाहिए.
<UserDevice>	Pricing	string	उपयोगकर्ता जिस डिवाइस से खोज रहा है उसके मुताबिक दरों को फ़िल्टर करता है. जितनी तरह के साइटमैप हो सकते हैं उनकी जानकारी यहां दी गई है: `mobile` `desktop` `tablet` `<UserDevice>` तय की गई क्वेरी के नतीजे के तौर पर, लेन-देन से जुड़ा एक मैसेज दिखना चाहिए. साथ ही, क्वेरी किए गए डिवाइस के टाइप के लिए सही `<Rates>` ब्लॉक तय करना चाहिए.

उदाहरण

होम में लोगों की मौजूदगी की जानकारी

यहां दिए गए उदाहरण में, <Context> में <Occupancy> के लिए लाइव किराये के बारे में क्वेरी दिखाई गई है. लाइव किराये से जुड़ी क्वेरी, तीन वयस्क मेहमानों के लिए है.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या की जानकारी

यहां दिए गए उदाहरण में, <Context> में <OccupancyDetails> के साथ लाइव किराये के बारे में क्वेरी दिखाई गई है. लाइव किराया से जुड़ी क्वेरी, चार मेहमानों के लिए है, जिनमें से दो बच्चे हैं. साथ ही, इस क्वेरी में मोबाइल डिवाइस से, अमेरिका में रहने वाले मेहमानों की बुकिंग के लिए वही दर दिखाई गई है:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="4"/>
        <Child age="12"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

एक से ज़्यादा कॉन्टेक्स्ट

नीचे दिए गए उदाहरण में, लाइव कीमत तय करने से जुड़ी क्वेरी में एक और <Context> एलिमेंट का इस्तेमाल दिखाया गया है.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
  <Context>
    <Occupancy>6</Occupancy>
    <OccupancyDetails>
      <NumAdults>4</NumAdults>
      <Children>
        <Child age="6"/>
        <Child age="10"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

क्वेरी & हिंट एक्सएमएल रेफ़रंस

<Hint> (हिंट रिस्पॉन्स मैसेज)

सिंटैक्स

सटीक यात्रा योजनाएं

चेक-इन रेंज

ठहरने की कुछ जगहें

विशेषताएं

चाइल्ड एलीमेंट

उदाहरण

सटीक यात्रा योजनाएं

चेक-इन रेंज

ठहरने की कुछ जगहें

<HintRequest>

सिंटैक्स

सिंटैक्स

विशेषताएं

चाइल्ड एलीमेंट

उदाहरण

हिंट रिक्वेस्ट मैसेज

<Query>

सिंटैक्स

मौजूदा कीमत

कॉन्टेक्स्ट के साथ

मेटाडेटा

विशेषताएं

चाइल्ड एलीमेंट

उदाहरण

कीमत से जुड़ी क्वेरी

मौजूदा किराये से जुड़ी क्वेरी

कॉन्टेक्स्ट क्वेरी के साथ

मेटाडेटा क्वेरी

<Context>

सिंटैक्स

सिंटैक्स

चाइल्ड एलीमेंट

उदाहरण

होम में लोगों की मौजूदगी की जानकारी

बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या की जानकारी

एक से ज़्यादा कॉन्टेक्स्ट

`<Hint>` (हिंट रिस्पॉन्स मैसेज)

`<HintRequest>`

`<Query>`

`<Context>`