क्वेरी मैसेज

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

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

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

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

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

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

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

किराये से जुड़ी क्वेरी वाले मैसेज

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

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

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

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

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

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

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

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

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

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

लाइव कीमत की क्वेरी इस्तेमाल करने के नियम

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

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

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

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

कॉन्टेक्स्ट के हिसाब से क्वेरी करने की सुविधा के साथ

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

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

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

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

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

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

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

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

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

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

यहां दिए गए उदाहरण में, किराये <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, 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>
  <Checkin>2025-07-10</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <Context>
        <UserCountry>US</UserCountry>
      </Context>
      <Occupancy>3</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
        <Children>
          <Child age="7"/>
        </Children>
      </OccupancyDetails>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Context>
        <UserCountry>GB</UserCountry>
      </Context>
      <Occupancy>1</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
      </OccupancyDetails>
    </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

Plus की सदस्यता के साथ की गई ऐसी बुकिंग जो दी गई रात से पहले शुरू हुई थीं, लेकिन उनमें वह रात शामिल है:

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>

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