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

इस सेक्शन में, 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 -->
    <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 -->
    <Property>1458700</Property>
    <Property>5418701</Property>
    <StaysIncludingRange>
      <!-- Required -->
      <FirstDate>2025-04-28</FirstDate>
      <!-- Optional -->
      <LastDate>2025-04-29</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 सभी

होटल का आईडी, जो होटल की सूची के आईडी जैसा ही होता है. एक <Item> ब्लॉक में, <Property> एलिमेंट की संख्या तय करने के लिए, यह ज़रूरी है कि आपने रिस्पॉन्स मैसेज के तौर पर, हिंट का किस टाइप का इस्तेमाल किया है:

  • यात्रा की पूरी जानकारी: ज़्यादा से ज़्यादा 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 को प्रॉपर्टी 12345 और 67890 के लिए, 3 जुलाई से 6 जुलाई के बीच की सभी यात्रा की योजनाएं मिलती हैं:

<!-- 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>

अलग-अलग अवधि के लिए ठहरने की सुविधा

नीचे दिए गए उदाहरण में, ठहरने की अवधि की सीमा के दो अलग-अलग इस्तेमाल दिखाए गए हैं. पहला, रातों की सीमा के लिए और दूसरा, एक रात के लिए:

<!-- 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>

इनमें से हर उदाहरण के लिए, 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 सेकंड है. हालांकि, इसमें बदलाव किया जा सकता है.

ज़्यादा जानकारी के लिए, जवाब के तौर पर मिलने वाले हिंट देखें.

उदाहरण

यहां दिए गए उदाहरण में, हिंट रिक्वेस्ट मैसेज दिखाया गया है:

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

यहां दिए गए उदाहरण में, हिंट रिक्वेस्ट मैसेज दिखाया गया है:

<?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 से मिले अनुरोध होते हैं. इनका इस्तेमाल, डिलीवरी के उन मोड के साथ किया जाता है जिनमें सदस्यों को सदस्यताएं खींचकर (पुल) और बदली गई कीमत पर दी जाती हैं.

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

किराया क्वेरी मैसेज से, प्रॉपर्टी और यात्रा की योजना के उन कॉम्बिनेशन की जानकारी मिलती है जिनके लिए आपने किराये की जानकारी दी है.

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

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

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>
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <PropertyList>
    <Property>hotel_id</Property>
    ...
  </PropertyList>
</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>

उदाहरण

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

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

<?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, 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> एलिमेंट की जानकारी दें.

ध्यान दें: ऐसा हो सकता है कि <Occupancy> किसी क्वेरी में हमेशा न दिखे. ऐसे मामलों में, आपको सभी बुकिंग के लिए किराये की जानकारी देनी चाहिए.
<OccupancyDetails> Pricing Object <Occupancy> से पहले आता है. मेहमानों के टाइप के हिसाब से जानकारी देता है. इनमें ये शामिल हैं:
  • <NumAdults>: वयस्क मेहमानों की संख्या
  • <Children> और <Child="age">: इससे पता चलता है कि कौनसे मेहमान बच्चे हैं (आम तौर पर, 0 से 17 साल के). साथ ही, इसमें हर बच्चे की उम्र की जानकारी भी शामिल की जा सकती है.

<OccupancyDetails> के साथ की गई क्वेरी के लिए, लेन-देन का मैसेज दिखना ज़रूरी नहीं है. हालांकि, इस मैसेज में हर <Occupancy> के लिए तय किए गए सही रूम बंडल दिखने चाहिए. अगर रूम बंडल उपलब्ध नहीं हैं, तो हमारा सुझाव है कि आप <OccupancyDetails> एलिमेंट की जानकारी दें.

ध्यान दें: ऐसा हो सकता है कि <OccupancyDetails> हमेशा किसी क्वेरी में न दिखे. ऐसे मामलों में, आपको यह मान लेना चाहिए कि सभी मेहमान वयस्क हैं.
<UserCountry> Pricing string

उपयोगकर्ता के देश के हिसाब से किराये को फ़िल्टर करता है. वैल्यू, दो अक्षरों वाला देश कोड है, जैसे कि अमेरिका के लिए "US" या क्षेत्र कोड, जैसे कि "यूरोप" के लिए "EU".

<UserCountry> की वैल्यू वाली क्वेरी से, लेन-देन का ऐसा मैसेज मिलना चाहिए जिसमें क्वेरी वाले देश के लिए तय किया गया सही <Rates> ब्लॉक शामिल हो.
<UserDevice> Pricing string

किराये को उस डिवाइस के हिसाब से फ़िल्टर करता है जिससे उपयोगकर्ता खोज कर रहा है. जितनी तरह के साइटमैप हो सकते हैं उनकी जानकारी यहां दी गई है:

  • mobile
  • desktop
  • tablet

<UserDevice> के साथ तय की गई क्वेरी से, क्वेरी किए गए डिवाइस टाइप के लिए तय किए गए सही <Rates> ब्लॉक के साथ, ट्रांज़ैक्शन मैसेज मिलना चाहिए.

उदाहरण

बुक किया हुआ

यहां दिए गए उदाहरण में, <Occupancy> के लिए <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>
</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>