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

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

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

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

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

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

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

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

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

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

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

जब आपके सर्वर को pricing Query मैसेज मिलता है, तो उसे <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, 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>

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