क्वेरी वाले मैसेज

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

क्वेरी मैसेज का रूट एलिमेंट <Query> है.

क्वेरी मैसेज का स्ट्रक्चर, इस बात पर निर्भर करता है कि मैसेज किस तरह का है:

• कीमत: Google एक क्वेरी मैसेज भेजता है, जिसमें चुने गए होटल के लिए किराये में बदलाव करने का अनुरोध किया जाता है.

• मेटाडेटा: Google, क्वेरी से जुड़ा एक मैसेज भेजता है. इस मैसेज में, बताए गए होटल में मौजूद कमरे और पैकेज की जानकारी का डेटा मांगा जाता है.

वह एंडपॉइंट तय किया जाता है जिसका इस्तेमाल Google, शुरुआती कॉन्फ़िगरेशन के दौरान क्वेरी मैसेज और लाइव प्राइसिंग क्वेरी के लिए करता है. ज़्यादा जानकारी के लिए, अपने तकनीकी खाता मैनेजर (टीएएम) से संपर्क करें.

Google, क्वेरी मैसेज को एचटीटीपी POST अनुरोध के तौर पर भेजता है. इसका Content-Type हेडर "application/xml" पर सेट होता है और User-Agent हेडर को Google-HotelAdsPrices पर सेट किया जाता है. इस नियम का अपवाद, Google-TravelAds-Live के ज़रिए प्राइस एंडपॉइंट इंटिग्रेशन की मैन्युअल जांच के दौरान होता है. उन सैंपल क्वेरी में User-Agent हेडर हो भी सकता है और नहीं भी.

क्वेरी मैसेज के लिए पूरा फ़ॉर्मैट, क्वेरी एक्सएमएल रेफ़रंस में मिल सकता है.

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

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

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

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

क्वेरी मैसेज तीन खास तरह के होते हैं:

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

2. कॉन्टेक्स्ट के साथ: यह सेटिंग चालू होने पर, Google से आपको भेजी जाने वाली हर क्वेरी में, उपयोगकर्ता के हिसाब से सुझाव शामिल किए जाते हैं. साथ ही, इन सुझावों में ऐसे सामान्य उपयोगकर्ताओं के बारे में जानकारी दी जाती है जो किसी प्रॉपर्टी या यात्रा की योजना के कॉम्बिनेशन के लिए खोज करते हैं. इन सुझावों का पालन करने से, आपके जवाबों को और असरदार बनाया जा सकता है.

3. मेटाडेटा: यह एक अनुरोध है, जिसमें बताई गई प्रॉपर्टी के लिए कमरों और पैकेज की जानकारी दी गई है.

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

मौजूदा कीमत से जुड़ी क्वेरी, Google के ऐसे अनुरोध होते हैं जिनमें लोगों की खोजों के जवाब में, रीयल-टाइम में कीमत से जुड़े अपडेट दिए जाते हैं. कोई व्यक्ति किसी होटल या यात्रा की योजना के लिए Google को खोज का अनुरोध करता है. किराये का डेटा उपलब्ध न होने या मौजूदा न होने की वजह से Google, खोज के दौरान आपसे किराये की जानकारी अपडेट करने का अनुरोध करता है. मौजूदा किराया क्वेरी के ज़रिए Google, किराये का पता लगाने और उसे खोज के दौरान नतीजों में दिखाने की कोशिश करता है.

लाइव कीमत से जुड़ी क्वेरी के सभी अनुरोधों के लिए, जवाब देने की समयसीमा आम तौर पर 4,000 मिलीसेकंड तक होती है. इस सीमा की जानकारी, लाइव कीमत तय करने से जुड़ी क्वेरी के अनुरोध में दी जाती है. अगर समयसीमा के अंदर जवाब नहीं दिया जा सका, तो हो सकता है कि आप किसी खास अवसर के लिए हिस्सा न ले पाएं. हालांकि, हमारा सुझाव है कि आप कोई कीमत दें, ताकि उसे कैश मेमोरी में सेव किया जा सके और आने वाले समय में इस्तेमाल किए जाने वाले अवसरों के लिए इस्तेमाल किया जा सके. रिस्पॉन्स के लिए कनेक्शन, दस मिनट तक या पार्टनर के कॉन्फ़िगरेशन में दिए गए निर्देशों के हिसाब से खुला रहता है.

लाइव किराये से जुड़ी क्वेरी में भी इन पैरामीटर के हिसाब से किराये की जानकारी मिल सकती है: उपयोगकर्ता का देश, डिवाइस का टाइप, बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या (मेहमानों की संख्या) और यह जानकारी कि वे मेहमान वयस्क हैं या बच्चे. मौजूदा किराये से जुड़ी क्वेरी से, किराये की ऐसी अप-टू-डेट वैल्यू दिखाई जा सकती है जो ग्राहक की खोज क्वेरी से मेल खाती हों.

मौजूदा कीमत से जुड़ी क्वेरी, कीमत को अपडेट करने का दूसरा तरीका है. कीमत में बदलाव करने का मुख्य तरीका अब भी पुल किया गया या बदला गया किराया है. लाइव किराये से जुड़ी क्वेरी से, उस कमी को दूर करने में मदद मिलती है जहां Google के पास होटल या यात्रा की योजना के कॉम्बिनेशन के किराये नहीं होते.

अहम जानकारी: खोज के नए अनुभव की वजह से, ईईए के किसी देश में उपयोगकर्ता के लिए लाइव क्वेरी की सुविधा अब उपलब्ध नहीं है. साथ ही, वह खोज नतीजों के पेज पर तारीखों या बदलावों की तारीखों के साथ नेविगेशन (होटल के हिसाब से) क्वेरी जारी करता है.

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

• दी गई यात्रा की योजना के लिए, कैश मेमोरी में सेव किया गया डेटा मौजूद नहीं है. ऐसा इसलिए, क्योंकि यात्रा की योजना के लिए अनुरोध की गई यात्रा की जानकारी असामान्य है. जैसे, तारीखें बहुत आगे की हैं या होटल को बहुत कम खोजा जाता है.

• अनुरोध की गई तारीख, डिफ़ॉल्ट तौर पर सेट नहीं होती है.

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

आम तौर पर, Google किराये की मौजूदा जानकारी के नतीजों को कैश मेमोरी में सेव करता है, ताकि उसी होटल या यात्रा की योजना के बारे में दोबारा क्वेरी न की जाए. वह एक होटल या यात्रा की योजना, दोनों के साथ-साथ, कई होटल या एक ही यात्रा की योजना, दोनों के लिए अनुरोध कर सकता है.

कॉन्टेक्स्ट के साथ लाइव किराया सुविधा की मदद से Google, किसी व्यक्ति के डिवाइस टाइप, उस देश के नाम जहां से बुकिंग की जा रही है, बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या के आधार पर, लाइव किराया तय करने के अनुरोध भेज सकता है. क्वेरी मैसेज और लेन-देन मैसेज, दोनों को बड़ा किया जाता है, ताकि क्वेरी पैरामीटर के बारे में बताने वाला <Context> एलिमेंट शामिल किया जा सके. संदर्भ के साथ लाइव किराया दिखाने से जुड़ी क्वेरी से मिलने वाली कीमतों को रूम बंडल के तौर पर कैश मेमोरी में सेव किया जा सकता है. ऐसा तब किया जा सकता है, जब यह एक खास बुकिंग के हिसाब से वयस्कों के लिए तय की गई एक खास कीमत हो और तय की गई दर के तौर पर. ऐसा तब किया जा सकता है, जब यह किराये उपयोगकर्ता के देश या उपयोगकर्ता के डिवाइस के लिए हो.

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

कॉन्टेक्स्ट क्वेरी के साथ, हमारे डेटाबेस को किसी खास प्रॉपर्टी या यात्रा की योजना के कॉम्बिनेशन के लिए अपडेट करने का नियमित अनुरोध किया जाता है. इनमें उपयोगकर्ता के ऐसे कॉन्टेक्स्ट की सूची होती है जो उन कॉम्बिनेशन के लिए लोकप्रिय हैं. अगर शर्त के साथ दर का इस्तेमाल किया जाता है, तो सभी संभावित उपयोगकर्ता के हिसाब से किराया भेजना महंगा हो सकता है. इसलिए, अपने जवाब को सीमित करने के लिए, उपयोगकर्ता के कॉन्टेक्स्ट की इस सूची का इस्तेमाल किया जा सकता है. सिर्फ़ बताए गए उपयोगकर्ता कॉन्टेक्स्ट के लिए, लौटाए जाने वाले शुल्क में ज़्यादातर काम की उपयोगकर्ता क्वेरी शामिल होती हैं.

अहम जानकारी: अगर आपको कॉन्टेक्स्ट क्वेरी के साथ जानकारी चाहिए, तो कृपया अपने तकनीकी खाता मैनेजर (टीएएम) से संपर्क करें. वह इस बात की पुष्टि करता है कि आपको ऐसे मैसेज मिलने हैं. इसके बाद, वह आपको क्वेरी में उपयोगकर्ता के कॉन्टेक्स्ट भेजना शुरू करने के लिए, कॉन्फ़िगरेशन में बदलाव करता है.

मेटाडेटा क्वेरी के मैसेज

मेटाडेटा क्वेरी मैसेज में, बताई गई प्रॉपर्टी के लिए कमरे और पैकेज की जानकारी होती है.

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

ज़्यादा जानकारी के लिए, कमरे और पैकेज का मेटाडेटा तय करना देखें.

कंट्रोल क्वेरी

इस सेक्शन में बताया गया है कि Google से क्वेरी मैसेज में किन प्रॉपर्टी और यात्रा की योजनाओं को कंट्रोल किया जा सकता है.

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

<ItineraryCapabilities> का इस्तेमाल करके, कीमत से जुड़ी क्वेरी की संभावित सीमाएं तय की जा सकती हैं. आप ऐसे नियम तय करते हैं जो तारीखों की सीमा और ठहरने की ज़्यादा से ज़्यादा अवधि तय करते हैं.

<MaxAdvancePurchase> और <MaxLengthOfStay> के लिए डिफ़ॉल्ट वैल्यू सेट की जा सकती हैं. ये वैल्यू, होटल या यात्रा की योजना के सभी कॉम्बिनेशन पर लागू होती हैं. होटल के ग्रुप के लिए भी ये सेटिंग तय की जा सकती हैं.

क्वेरी मैसेज के उदाहरण

इस सेक्शन में, कीमत तय करने वाले क्वेरी मैसेज और मेटाडेटा के क्वेरी मैसेज के कई उदाहरण दिखाए गए हैं. इसके अलावा, क्वेरी एक्सएमएल रेफ़रंस में अन्य उदाहरण दिए गए हैं.

यात्रा की योजना का सैंपल

यहां दिए गए उदाहरण में, किराया <Query> दिखाया गया है. इसमें चार होटलों के किराये में बदलाव का अनुरोध किया गया है. यह सुविधा 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>

इस उदाहरण में, हर होटल के किराये से जुड़े अपडेट का अनुरोध किया गया है:

5/23/18 - 6/26/18

मौजूदा कीमत से जुड़ी क्वेरी का उदाहरण

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

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

यह उदाहरण किसी एक होटल के लिए किराये का अनुरोध करता है:

6/23/23 - 6/25/23

इस क्वेरी के लिए लेन-देन के मैसेज का सैंपल, कीमत और रूम इन्वेंट्री (लेन-देन) एक्सएमएल रेफ़रंस में देखा जा सकता है.

कॉन्टेक्स्ट क्वेरी के साथ उदाहरण

यहां दिए गए उदाहरण में, कॉन्टेक्स्ट क्वेरी के साथ एक उदाहरण दिया गया है:

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

'कॉन्टेक्स्ट क्वेरी' से सिर्फ़ उपयोगकर्ता के देश के बारे में जानकारी मिलती है. आने वाले समय में, इस तरह की क्वेरी में उपयोगकर्ता के डिवाइस और बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या के बारे में भी जानकारी दी जा सकती है.

चेक-इन करने की तारीख की सीमाएं

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

यहां दिए गए उदाहरण में, चेक इन करने की तारीख की सीमाओं के लिए कीमत <Query> से जुड़ा मैसेज दिखाया गया है:

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

इस उदाहरण में, ठहरने की इन जगहों (हर होटल के लिए) के लिए किराये से जुड़े अपडेट का अनुरोध किया गया है:

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

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

यहां दिए गए उदाहरण में, ठहरने की कुछ जगहों के लिए किराया <Query> से जुड़ा मैसेज दिखाया गया है:

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

इस उदाहरण में, हर होटल के किराये से जुड़े अपडेट का अनुरोध किया गया है:

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

इसके अलावा, ठहरने की उस अवधि के दौरान जो रात के समय पहले शुरू होती है (हालांकि, इसमें यह जानकारी भी शामिल होती है):

5/20/23 - 5/23/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

मेटाडेटा क्वेरी का मैसेज

इस उदाहरण में, <Query> मैसेज दिखाया गया है. इसमें कई प्रॉपर्टी के लिए, कमरे और पैकेज की जानकारी के मेटाडेटा को अपडेट करने का अनुरोध किया गया है:

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

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