क्वेरी मैसेज

क्वेरी मैसेज, 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> एलिमेंट को शामिल करने के लिए बड़ा किया जाता है. कॉन्टेक्स्ट के साथ लाइव क्वेरी से मिले किराये को रूम बंडल के तौर पर कैश मेमोरी में सेव किया जा सकता है. ऐसा तब किया जा सकता है, जब वह किराया किसी खास व्यक्ति के लिए हो. इसके अलावा, इसे खास किराया के तौर पर कैश मेमोरी में सेव किया जा सकता है. ऐसा तब किया जा सकता है, जब वह किराया किसी देश के उपयोगकर्ता या उपयोगकर्ता के डिवाइस के लिए हो.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<?xml version="1.0" encodin>g<=&quo>t;U<TF-8&qu>ot;?
Query<
  Check>in2<023-05>-<23/Chec>kin<
  Nights3/N>ights<
  Prope>rtyL<ist
    P>roper<typid5/P>rope<rty
    P>roper<typid8/P>roper<ty
    Pr>opert<ypid13/P>roper<ty
    Pr>ope<rtypid21/Prop>e<rty
  >/PropertyList
/Query

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

5/23/18 - 6/26/18

मौजूदा किराया दिखाने वाली क्वेरी का उदाहरण

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

<?xml version="1.0" encodin>g<="UTF-8"?
Query lat>e<ncySensitive="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> Li<ve Pric>ing Query <request >--
<  Chec>k<in2023->05-<23/Checkin>
  <Nights2/Nig>h<ts
  DeadlineMs500/DeadlineMs
!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a> Li<ve Pricing Q>uery <request >--
  Pr<opertyLis>t
 <   Pro>perty678<1291/Property
  /PropertyList
!-- Note that Context tags> ar<e poten>t<ially repeatable --
  Context
!-- The total number of guests occupying> the <room (adu>l<ts+childre>n) --<
    Occupancy3/>Occupan<cy
    Oc>c<upancyDeta>i<ls
      NumAdults2/NumAdults
!-- In this example one of the >3 guest<s is a 5>yr old ch<ild --
      C>hildren<
        >Child< age="5">;</
      /Children
    /OccupancyDetails
!-- The user was locate>d in <the US when> t<his search w>a<s made --
    UserCountryUS/UserCountry
!-- The user was searching from >a mob<ile device> at th<e time of s>ear<ch --
  > < UserDevicemobile/UserDevice
  /Context
/Query

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

6/23/23 - 6/25/23

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

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

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

कॉन्टेक्स्ट के साथ बुनियादी क्वेरी

<?xml version="1.0" encodin>g<=&quo>t;U<TF-8&qu>ot;?
Query<
  Check>in2<023-05>-<23/Chec>kin<
  Nights2/Nights
 > Prop<ertyContextList>
    Pr<opertyCo>ntext
 <     Property867<5309/Property
      !-- In the future, device m>ight be< specif><ied --
    >  <ContextUserC><ountryUS>/UserCo<untry/C><ontext
    >  <ContextUserC><ountryGB>/User<Country/Context
>    /<PropertyContext>
    Pr<opertyCo>ntext
 <     Property867<5310/Pro>perty
 <     Property867<5311/Pr><operty
    >  <ContextUserC><ountryCA>/User<Country/Context
>   < /PropertyContext
  >/<Proper>tyContextList
/Query

कॉन्टेक्स्ट के साथ क्वेरी, जिसमें ऑक्यूपेंसी की जानकारी भी शामिल हो

<?xml version="1.0" encodin>g<=&quo>t;U<TF-8&qu>ot;?
Query<
  Check>in2<025-07>-<10/Chec>kin<
  Nights2/Nights
 > Prop<ertyContextList>
    Pr<opertyCo>ntext
 <     Property867<5309/Pr>operty
  <    >Context
 <       UserCountryU<S/UserCo>untry
 <     /Cont<ext
      >Occupan<cy3/Occupancy
  >    Occup<ancyDetai>l<s
        >NumAdults<2/NumAdu>lts
       < Children
    >      Chi<ld age=&q>uot;7&q<uot;/
        /Ch>ildre<n
      /Occupan>cyDet<ails
    /Prope>rtyCont<ext
    >Propert<yContext
>      P<roperty>8675310/P<roperty
   >  < Context
   >     Us<erCountr>yGB/Use<rCountry
> <     /Context
   <   Occupa>ncy1/Occupancy
 <     Occup<ancyDetail>s
     <   NumAdul>ts1/NumAdult<s
      /Occupan>cyD<etails
    /Property>C<ontext>
  /PropertyContextList
/Query

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

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

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

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

<?xml version="1.0" encodin>g<=&quo>t;U<TF-8">;?
Query
 < Fi>rstDate202<3-05-23/>FirstDate
<  LastDat>e20<23-05->2<6/LastD>ate<
  Nights3/N>ights<
  Prope>rtyL<ist
    P>roper<typid5/P>rope<rty
    P>roper<typid8/P>roper<ty
    Pr>opert<ypid13/P>roper<ty
    Pr>ope<rtypid21/Prop>e<rty
  >/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" encodin>g<=&quo>t;U<TF-8">;?
Query
 < Fi>rstDate202<3-05-23/>FirstDate
<  LastDat>e20<23-05-26/LastD>a<te
  AffectedNi>ght<s3/AffectedN>ights<
  Prope>rtyL<ist
    P>roper<typid5/P>rope<rty
    P>roper<typid8/P>roper<ty
    Pr>opert<ypid13/P>roper<ty
    Pr>ope<rtypid21/Prop>e<rty
  >/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" encodin>g<=&quo>t;U<TF-8"?
Query
 > Hote<lInfoPro>pert<ies
    P>roper<typid5/P>rope<rty
    P>roper<typid8/P>roper<ty
    Pr>opert<ypid13/P>roper<ty
    Pr>ope<rtypid21/Property
  >/<HotelI>nfoProperties
/Query

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