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

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

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

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

• कीमत: Google एक क्वेरी मैसेज भेजता है, जिसमें आपके चुने हुए होटल.

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

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

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

क्वेरी मैसेज की पूरी जानकारी यहां दी गई है: क्वेरी एक्सएमएल रेफ़रंस.

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

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

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

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

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

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

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

3. मेटाडेटा: यह आईडी, बताई गई प्रॉपर्टी.

किराये की लाइव क्वेरी

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

मेटाडेटा क्वेरी मैसेज में कमरे और पैकेज की जानकारी शामिल होती है .

मेटाडेटा क्वेरी का मैसेज मिलने पर, आपको <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>

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