खास जानकारी
रेट मैसेज (OTA_HotelRateAmountNotifRQ
) में, हर तरह के कमरे के लिए, एक रात का किराया और तारीख की खास सीमाओं के लिए रेट प्लान के कॉम्बिनेशन के बारे में बताया जाता है. 'किराये की जानकारी दें' मैसेज में, Google, बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या के हिसाब से किराये की सुविधा देता है. इससे, एक रात के लिए अलग-अलग किराये की जानकारी दी जा सकती है. यह किराये, यात्रियों की ज़्यादा से ज़्यादा संख्या के हिसाब से तय किए जाते हैं.
नीचे दिए गए सेक्शन में सामान्य दिशा-निर्देश, एक बुनियादी उदाहरण, और किराये की जानकारी जोड़ने और अपडेट करने के साथ-साथ, किराया बताने वाला मैसेज भेजने के तरीके बताने वाले तरीकों के बारे में बताया गया है.
मैच रेट का व्यवहार
अगर उपयोगकर्ता कुछ खास बुकिंग के लिए अनुरोध करते हैं, तो उन्हें दिखने की दर इस बात पर निर्भर करती है कि आपने किराया तय करने वाले मैसेज में किराया कैसे तय किया है. इस सेक्शन में बताया गया है कि उपयोगकर्ता के इन अनुरोधों को आपके कमरों के किराये की तुलना में कैसे किया जाता है. ऐसा उनके अनुरोध और आपकी तय की गई दरों के आधार पर किया जाता है.
मुख्य सिद्धांत
किसी खास बुकिंग के लिए तय किया गया किराया, कम बुकिंग वाली सभी जगहों पर लागू होता है. हालांकि, ऐसा तब तक होगा, जब तक बुकिंग के लिए अलग से किराया तय न किया गया हो.
तय की गई सीमा से ज़्यादा बुकिंग के लिए किए गए अनुरोध को लागू नहीं किया जा सकता.
व्यस्तता के हिसाब से तय की गई कीमत, हर तारीख की कीमत और एलओएस के हिसाब से तय किए गए मॉडल, दोनों पर लागू होती है. इनके बारे में यहां बताया गया है. इसका मतलब है कि हर बुकिंग के लिए, किराये तय किए जा सकते हैं. अगर किसी खास बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या नहीं पता की जाती है, तो अगली सबसे ज़्यादा बुकिंग के हिसाब से किराया तय किया जाता है. दूसरे मेहमानों और बच्चों के लिए भी शुल्क तय किए जा सकते हैं. इसके लिए,
AdditionalGuestAmounts
याExtraGuestCharges
का इस्तेमाल करें. यह शुल्क, कमरे के लिए तय की गई सीमा के हिसाब से लिया जाता है.
फ़ायदे और उदाहरण
- क्षमता
एक जैसी किराया वाली कई बुकिंग के लिए, आपको हर बुकिंग के लिए किराया सेट करने की ज़रूरत नहीं है. अपने मैसेज को आसान बनाने के लिए, बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या सबसे ज़्यादा पर सेट की जा सकती है. यह वैल्यू, कमरे के टाइप और रेट प्लान के हिसाब से तय होती है. लोगों को हर बुकिंग के लिए, आपकी तय की गई वैल्यू से कम या उसके बराबर, बुकिंग का किराया दिखेगा.
उदाहरण के लिए: एक से चार तक के लोगों के लिए, कमरे के टाइप और रेट प्लान की दरें एक जैसी होती हैं. चार लोगों के रहने की ज़्यादा से ज़्यादा संख्या के लिए एक दर सेट करने के लिए, दर वाले मैसेज का इस्तेमाल करें. एक, दो, और तीन गुना बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या को खोजने वाले उपयोगकर्ताओं को वही दर दिखेगी. पांच साल और उससे ज़्यादा उम्र के ग्राहकों को खोजने वाले उपयोगकर्ताओं को किराये की जानकारी नहीं दिखेगी.
- कंट्रोल
अन्य बुकिंग के लिए, अलग-अलग किराये साफ़ तौर पर दिए जा सकते हैं. अगर आपको इस बात पर ज़्यादा कंट्रोल चाहिए कि Google, बुकिंग के लिए अनुरोध को किस तरह से मैच करता है, तो हर बुकिंग वैल्यू के लिए अलग दर भेजें.
उदाहरण: अगर तीन और पहली बुकिंग के लिए किराये तय किए गए हैं, तो एक व्यक्ति के लिए बुकिंग करने पर, सिंगल लोगों के लिए तय किया गया किराया दिखेगा. दो लोगों के लिए बुकिंग करने पर, दो लोगों के लिए बुकिंग करने पर किराया दिखेगा. साथ ही, चार या उससे ज़्यादा लोगों के लिए तय किए गए किराये नहीं दिखेंगे.
दर से जुड़ी अलग-अलग स्थितियों के ज़्यादा उदाहरणों के लिए, कैसे करें देखें.
ज़रूरी और वैकल्पिक एलिमेंट
एक्सएमएल रेफ़रंस, ज़रूरी और वैकल्पिक एलिमेंट की जानकारी देता है. एट्रिब्यूट और चाइल्ड एलिमेंट के बारे में जानने के लिए, रेट एलिमेंट और एट्रिब्यूट देखें.
सिंटैक्स और स्कीमा
रेट वाला मैसेज बनाते समय, रेट सिंटैक्स के उदाहरण का इस्तेमाल रेफ़रंस के तौर पर करें. इससे यह पक्का किया जा सकेगा कि आपने सही फ़ॉर्मैट का इस्तेमाल किया है.
अपने फ़ीड को Google पर सबमिट करने से पहले, पब्लिश किए गए स्कीमा के साथ उनकी पुष्टि करने के लिए, xmllint जैसे तीसरे पक्ष के एक्सएमएल टूल का इस्तेमाल किया जा सकता है. रेट मैसेज स्कीमा के लिए, होटल विज्ञापन स्कीमा देखें.
कीमत तय करने के मॉडल
मौजूदा कीमत
यह ज़्यादातर प्रॉपर्टी के लिए कीमत तय करने का स्टैंडर्ड मॉडल है. per-date
कीमत तय करने के मॉडल में ऐसे किराये तय किए जाते हैं जिन्हें ठहरने की तारीखों के हिसाब से जोड़ा जाता है, ताकि कुल किराये पर पहुंचा जा सके. इस मॉडल में, Rate
एलिमेंट के तहत आने वाली सभी दरों को
<StatusApplicationControl>
में बताई गई, ठहरने की तारीखों की सीमा पर लागू होने वाले किराये के तौर पर समझा जाता है.
एलओएस आधारित कीमत
एलओएस पर आधारित (ठहरने की अवधि) वाला मॉडल, आने की तारीख और ठहरने की कुल अवधि के हिसाब से सेट किए गए किराये पर आधारित होता है. एलओएस आधारित कीमत तय करने के मॉडल के तहत बताई गई दरें, हर दिन के हिसाब से होती हैं. उदाहरण के लिए, अगर तीन लोगों के ठहरने की कुल अवधि के लिए 100 डॉलर की दर भेजी जाती है, तो कुल किराया 3x100 डॉलर=300 डॉलर के हिसाब से लगाया जाएगा.
StatusApplicationControl
एलिमेंट पर RatePlanType="26"
तय करके, एलओएस पर आधारित कीमत तय करने वाले मॉडल का इस्तेमाल किया जा सकता है. आपको अपने एक्सएमएल में Rate
एलिमेंट पर RateTimeUnit
और UnitMultiplier
एट्रिब्यूट भी सेट करने होंगे. ऐसा करने से, दिए गए Rate
एलिमेंट के तहत मिलने वाली सभी दरें, <StatusApplicationControl>
में आने वाली तारीखों और UnitMultiplier
के लिए तय की गई एलओएस वैल्यू के हिसाब से तय रहेंगी.
एक ही खाते में, हर तारीख और एलओएस पर आधारित कीमत तय करने के दोनों मॉडल इस्तेमाल किए जा सकते हैं. हालांकि, हर प्रॉपर्टी को सिर्फ़ एक कीमत तय करने वाले मॉडल का इस्तेमाल करना चाहिए. एलओएस पर आधारित कीमत लागू करते समय इन बातों का ध्यान रखें:
- एलओएस के हिसाब से तय की गई कीमत पर, ठहरने की अलग-अलग अवधि की दरों को नहीं जोड़ा जाता. उदाहरण के लिए, 4 की एलओएस दर तय करने के लिए, तीन लोगों के एलओएस दर को एक के एलओएस के साथ नहीं जोड़ा जाता. चार की एलओएस दर साफ़ तौर पर बताई जानी चाहिए.
- एलओएस के हिसाब से एक रात के लिए किराये का इस्तेमाल, अलग-अलग रात के लिए तय किए गए किराये के तौर पर नहीं किया जाता.
- हर प्रॉपर्टी को, एलओएस के हिसाब से या हर तारीख की कीमत के हिसाब से ही कीमत तय करनी चाहिए. यह इस बात पर निर्भर करता है कि आपके सिस्टम में दरें किस तरह दिखाई जाती हैं.
अपने खाते में, एलओएस के हिसाब से कीमत तय करने की सुविधा चालू करने के लिए, अपने TAM से अनुरोध करें या हमसे संपर्क करें.
दिशा-निर्देश या कार्रवाइयां
- मौजूदा कीमत
Delta
: कमरा टाइप, किराया प्लान, और ठहरने की तारीखों के लिए,<StatusApplicationControl>
में बताई गई सिर्फ़ बुकिंग के हिसाब से किराये की जानकारी जोड़ें या अपडेट करें.- दरों से जुड़े अपडेट के लिए, डिफ़ॉल्ट रूप से
Delta
कार्रवाई का इस्तेमाल किया जाता है. Delta
अपडेट से, अन्य बुकिंग पर पहले से सेव किए गए किराये में कोई बदलाव नहीं होता. उदाहरण के लिए, अगर आपने एक या दो लोगों के लिए बुकिंग की तय की गई दरें तय की हैं और एक ही कमरे के लिए,Delta
के किराये का अपडेट भेजा है, तो दो लोगों के लिए तय किए गए किराये में कोई बदलाव नहीं होगा.
- दरों से जुड़े अपडेट के लिए, डिफ़ॉल्ट रूप से
Overlay
: कमरे के टाइप, किराया प्लान, और<StatusApplicationControl>
में बताई गई तारीखों के लिए, हर व्यस्तता की सभी मौजूदा दरें मिटाएं और उनकी जगह नई दरें डालें. उदाहरण के लिए, अगर आपने एक या दो लोगों के लिए अलग-अलग किराया तय किया है और एक कमरा बुक करने परOverlay
अपडेट किया है, तो Google, बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या को हटा देगा.Remove
: कमरा टाइप, किराया प्लान, और<StatusApplicationControl>
में बताई गई तारीखों के लिए, हर व्यक्ति के ठहरने की सभी मौजूदा दरें मिटाएं.- एलओएस आधारित कीमत
Delta
: कमरे के टाइप, रेट प्लान, और चेक इन करने की तारीखों के लिए,<StatusApplicationControl>
में बताई गई खास तारीखों के लिए, हर एलओएस वैल्यू के हिसाब से दरें जोड़ें या अपडेट करें. अपडेट किए गए एलओएस वैल्यू से जुड़ी, हर बुकिंग के हिसाब से किराये को बदलता है.- दरों से जुड़े अपडेट के लिए, डिफ़ॉल्ट रूप से
Delta
कार्रवाई का इस्तेमाल किया जाता है. Delta
के अपडेट में, ठहरने की अन्य अवधि के लिए पहले से सेव किए गए किराये में कोई बदलाव नहीं किया जाएगा. उदाहरण के लिए, अगर आपने एलओएस 1 और 2 के लिए दरें तय की हैं और एलओएस 1 के लिएDelta
के किराये का अपडेट भेजें, तो एलओएस 2 में हर व्यक्ति की बुकिंग की दरों में कोई बदलाव नहीं होगा.Delta
के अपडेट में, ठहरने की कुल अवधि के लिए पहले से स्टोर किए गए किराये की जगह लागू हो जाती है. उदाहरण के लिए, अगर आपने एलओएस 1 के लिए एक या दो लोगों के लिए बुकिंग की दर तय की है और एलओएस 1 के लिएDelta
के तौर पर सिर्फ़ एक बुकिंग दर वाला अपडेट भेजा है, तो दो लोगों की बुकिंग पर लागू होने वाली दर हटा दी जाएगी.
- दरों से जुड़े अपडेट के लिए, डिफ़ॉल्ट रूप से
Overlay
:<StatusApplicationControl>
में बताई गई एलओएस, कमरे का टाइप, रेट प्लान, और चेक इन करने की तारीखों के लिए, हर व्यक्ति के रहने की सभी मौजूदा दरों को मिटाएं और उनकी जगह नई किराये तय करें. उदाहरण के लिए, अगर आपने एलओएस 1 और 2 के लिए दरें तय की हैं और आप एलओएस 1 के लिएOverlay
अपडेट भेजते हैं, तो Google पिछली सभी दरों (एलओएस 1 और 2 दोनों) को हटा देगा और अपडेट होने के बाद सिर्फ़ एलओएस 1 की दर ही बनी रहेगी.Remove
:<StatusApplicationControl>
में बताए गए रूम टाइप, रेट प्लान, और चेक इन करने की सभी तारीखों के लिए, एलओएस की सभी मौजूदा दरों को मिटाएं.- टैक्स के बारे में जानकारी
अगर टैक्स और शुल्क आसान हैं, तो कुल रकम की जानकारी
AmountAfterTax
का इस्तेमाल करके दी जा सकती है. कॉम्प्लेक्स टैक्स, जैसे कि हर रात ठहरने पर लागू होने वाले टैक्स और शुल्क कोAmountAfterTax
में नहीं दिखाया जा सकता.आम तौर पर, Google
AmountAfterTax
के बजायTaxFeeInfo
का इस्तेमाल करने का सुझाव देता है.अगर हो सके, तो आपको
AmountBeforeTax
को शामिल करना चाहिए, भले ही आपनेAmountAfterTax
की जानकारी दी हो. ऐसा इसलिए है, क्योंकि कुछ स्थान-भाषाओं (जैसे, अमेरिका) में डिफ़ॉल्ट रूप से, टैक्स के बिना दिखने वाली कीमत दिखती है.वे सभी टैक्स और शुल्क शामिल करने होंगे जो उपयोगकर्ता को चुकाने हैं. जैसे, वैट, ठहरने का टैक्स, सफ़ाई का शुल्क, शहर का टैक्स वगैरह. भले ही, इसका पेमेंट बुकिंग के समय न किया जा रहा हो या यह पेमेंट सीधे प्रॉपर्टी में न हो.
उदाहरण
इस सेक्शन में ज़रूरी और वैकल्पिक एलिमेंट का इस्तेमाल करके रेटिंग देने वाले मैसेज का बुनियादी उदाहरण दिया गया है. अपनी फ़ाइल तैयार करने के बाद, आपको इसे यहां दिए गए एंडपॉइंट पर एक POST मैसेज का इस्तेमाल करके Google को भेजना होगा:
https://www.google.com/travel/hotels/uploads/property_data
मैसेज को पुश/पोस्ट करने के तरीके के बारे में ज़्यादा जानने के लिए, मैसेज भेजना लेख पढ़ें.
HotelCode
के लिए, प्रॉपर्टी की पहचान के लिए उस यूनीक होटल आईडी का इस्तेमाल करें जिसका इस्तेमाल आपने अपने सिस्टम में किया है. यह मान, होटल सूची फ़ीड में <listing>
एलिमेंट में <id>
का इस्तेमाल करके दिए गए होटल आईडी से मेल खाना चाहिए. <PackageID>
और <RoomID>
के लिए, उसी आईडी का इस्तेमाल करें जिसे आपने सिस्टम में रेट प्लान और कमरे के टाइप के लिए इस्तेमाल किया है. Google आपके प्रॉडक्ट की कीमतें और डेटा
सही तरीके से दिखा रहा है या नहीं, यह पक्का करने के लिए
आपके सिस्टम में लगातार काम करते रहना ज़रूरी है.
इस उदाहरण में, Delta
कार्रवाई का इस्तेमाल करके दरें सेट करने का तरीका बताया गया है:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-02-25T20:50:37-05:00"
Version="3.0"
NotifType="Delta">
<POS><Source><RequestorID ID="partner_key" /></Source></POS>
<RateAmountMessages HotelCode="HotelID">
<RateAmountMessage>
<StatusApplicationControl Start="2022-12-01"
End="2022-12-31"
InvTypeCode="RoomID"
RatePlanCode="PackageID" />
<Rates>
<Rate>
<BaseByGuestAmts>
<BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
<BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
<BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
<BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
</BaseByGuestAmts>
</Rate>
</Rates>
</RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>
कैसे करें
इस सेक्शन में उन स्थितियों के समाधान दिए गए हैं जिनका सामना आपको रेटिंग मैसेज भेजते समय हो सकता है.
किराये जोड़ने, हटाने, और अपडेट करने के तरीके जानने के लिए, किराये के उदाहरण देखें.
पहली स्थिति: हर व्यक्ति की बुकिंग के लिए किराये में बदलाव करने का तरीका
जानकारी
एक रात के लिए पहले सिर्फ़ दो लोगों के लिए ही किराये तय किए जाते थे (जो एक व्यक्ति के लिए ही बुकिंग पर लागू होता है). हालांकि, अब एक व्यक्ति के लिए किराया कम हो गया है.
समस्या का हल
Delta
के स्कोप वाला डिफ़ॉल्ट अपडेट इस्तेमाल करके, व्यस्तता की नई दर भेजें. इस नई वैल्यू से, व्यस्तता 2 की दर पर कोई असर नहीं पड़ता.
दूसरी स्थिति: किसी प्रॉपर्टी के लिए हर व्यक्ति की बुकिंग के किराये को बदलने का तरीका
जानकारी
आपने पहले एक से चार तक की बुकिंग के लिए किराया तय किया था. हालांकि, अब सिर्फ़ 1 और 2 वाली जगहों के लिए ही किराया मान्य है.
समस्या का हल
किसी प्रॉपर्टी, कमरे के टाइप, रेट प्लान, और तारीख(तारीखों) के लिए, बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या बदलने के लिए, NotifType="Overlay"
का इस्तेमाल करें. इस स्थिति में, Overlay
कार्रवाई में, 1 और 2 ऑक्वेंस के लिए किराये की जानकारी दी जाएगी.
तीसरी स्थिति: एक से ज़्यादा बुकिंग के लिए एक जैसी दर कैसे सेट करें
जानकारी
कुछ खास लोगों के लिए तय किया गया किराया, ऐसे ग्रुप को बेचा जा सकता है जिसमें कम लोग हों. इस स्थिति में, ज़्यादा से ज़्यादा संख्या के हिसाब से किराये का अपडेट भेजकर, अपने मैसेज को आसान बनाया जा सकता है.
समस्या का हल
अगर एक से ज़्यादा बुकिंग के लिए एक ही किराया तय है, तो व्यस्तता की सबसे ज़्यादा वैल्यू सेट करें. यह वैल्यू, रूम टाइप और रेट प्लान के हिसाब से सेट की जा सकती है. इससे कम बुकिंग के लिए, इस वैल्यू का इस्तेमाल अपने-आप होगा. इसका मतलब है कि 1 से 6 के लिए, अगर एक ही किराया है, तो एक रात का किराया दोहराने की ज़रूरत नहीं है. बस इसे 6 के लिए सेट करें.