इस सेक्शन में, 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 | सभी | होटल की सूची के आईडी का इस्तेमाल करने वाले होटल का आईडी.
|
<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 सेकंड है, लेकिन इसमें बदलाव हो सकता है. ज़्यादा जानकारी के लिए, हिंट रिस्पॉन्स मैसेज देखें. |
उदाहरण
इस उदाहरण में, सुझाव के लिए अनुरोध वाला मैसेज दिखाया गया है:
हिंट रिक्वेस्ट मैसेज
इस उदाहरण में, संकेत के लिए अनुरोध वाला मैसेज दिखाया गया है:
<?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> | लाइव कीमत वाली क्वेरी के लिए, ऐसे कुछ पैरामीटर तय करता है जिनके तहत
क्वेरी की जाती है. चाइल्ड एलिमेंट में ये शामिल हैं:
|
<FirstDate> | Pricing | Date | यात्रा की अलग-अलग योजनाओं के शुरू होने की तारीख, जिस पर किराया लागू होता है. इस एलिमेंट का इस्तेमाल सिर्फ़ चेक-इन तारीख की सीमा वाली कीमत से जुड़ी क्वेरी के लिए किया जाता है. यह क्वेरी, बदली हुई कीमत के साथ इस्तेमाल की जाती है. |
<HotelInfoProperties> | Metadata | string | एक या एक से ज़्यादा ऐसी प्रॉपर्टी जिनके लिए, Google को अपडेट किए गए कमरे और रूम बंडल का मेटाडेटा, Query मैसेज के मेटाडेटा में चाहिए. इस एलिमेंट में
एक या एक से ज़्यादा ऐसे <Property> एलिमेंट हो सकते हैं जिनसे
होटल प्रॉपर्टी के आईडी की जानकारी मिलती हो. |
<LastDate> | Pricing | Date | यात्रा की अलग-अलग अवधि के खत्म होने की तारीख, जिस पर किराया लागू होता है. इस एलिमेंट का इस्तेमाल सिर्फ़ चेक-इन की तारीख की सीमा वाली कीमत से जुड़ी क्वेरी के लिए किया जाता है. इन क्वेरी के लिए पुल + हिंट का इस्तेमाल किया जाता है. |
<Nights> | Pricing | integer | किसी खास यात्रा की योजना के लिए रातों की संख्या, ज़्यादा से ज़्यादा 30. |
<PropertyList> | Pricing | Object | होटल के एक या एक से ज़्यादा आईडी, जिनके लिए किराये में बदलाव करना ज़रूरी है.
<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 | इससे मेहमानों की कुल संख्या का पता चलता है. हालांकि, यह ज़रूरी नहीं है, लेकिन ध्यान दें: ऐसा हो सकता है कि |
<OccupancyDetails> | Pricing | Object | इससे पहले <Occupancy> है. मेहमानों के बारे में उनके टाइप के हिसाब से बताता है.
इनमें ये शामिल हैं:
हालांकि, यह ज़रूरी नहीं है, लेकिन ध्यान दें: ऐसा हो सकता है कि |
<UserCountry> | Pricing | string | उपयोगकर्ता जिस देश में है उसके हिसाब से दरों को फ़िल्टर करता है. यह वैल्यू
दो अक्षरों वाला देश का कोड हो सकती है, जैसे कि अमेरिका के लिए
|
<UserDevice> | Pricing | string | उपयोगकर्ता जिस डिवाइस से खोज रहा है उसके मुताबिक दरों को फ़िल्टर करता है. जितनी तरह के साइटमैप हो सकते हैं उनकी जानकारी यहां दी गई है:
|
उदाहरण
होम में लोगों की मौजूदगी की जानकारी
यहां दिए गए उदाहरण में, <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>