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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

आम तौर पर, 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>

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