यह पेज एक्सएमएल पर आधारित लेन-देन के मैसेज के लिए रेफ़रंस देता है.
<Transaction>
लेन-देन से जुड़े मैसेज का रूट एलिमेंट
<Transaction>
है. यह एक कंटेनर है, जिसमें
कमरों और पैकेज के लिए कमरे, उनके पैकेज, और उनका किराया और उनकी उपलब्धता की जानकारी.
<Transaction>
एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है
लेन-देन के मैसेज की एक्सएमएल हैरारकी:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
<Transaction>
का इस्तेमाल रूट एलिमेंट के तौर पर करने वाले मैसेज के लिए, कम से कम एक मैसेज होना ज़रूरी है
चाइल्ड एलिमेंट. लेन-देन मैसेज में कई चाइल्ड एलिमेंट हो सकते हैं, जैसे कि
अगर मैसेज का कुल साइज़ 100 एमबी से ज़्यादा न हो.
सिंटैक्स
<Transaction>
एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="timestamp" id="transaction_ID">
<!-- Defines data about a room or package (Room Bundle) -->
<PropertyDataSet>
...
</PropertyDataSet>
<!-- Updates/sets prices and availability for rooms and Room Bundles -->
<!-- (Also removes itineraries from inventory) -->
<Result>
...
</Result>
</Transaction>
विशेषताएं
<Transaction>
एलिमेंट में ये एट्रिब्यूट मौजूद हैं:
एट्रिब्यूट | ज़रूरी है? | टाइप | ब्यौरा |
---|---|---|---|
id | Required | स्ट्रिंग | लेन-देन से जुड़े हर मैसेज के लिए, एक यूनीक आइडेंटिफ़ायर. |
partner | Optional | string | वह पार्टनर खाता जिससे लेन-देन का मैसेज मिला है. आपने लोगों तक पहुंचाया मुफ़्त में आम तौर पर इसका इस्तेमाल तब करें, जब आपका बैकएंड एक से ज़्यादा वीडियो के लिए कीमत फ़ीड उपलब्ध कराता हो पार्टनर खाते. इस स्ट्रिंग का मान "Partner key" है वैल्यू यहां दी गई है खाते की सेटिंग वाले पेज पर जाएं. |
timestamp | Required | DateTime | वह समय जब लेन-देन मैसेज भेजा गया. पिछले 24 घंटों के भीतर के टाइमस्टैंप के साथ भेजा गया कोई भी मैसेज प्रोसेस किया जा सकता है और जिन्हें नहीं खारिज किया गया है. मैसेज |
चाइल्ड एलीमेंट
<Transaction>
एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:
चाइल्ड एलिमेंट | ज़रूरी है? | टाइप | ब्यौरा |
---|---|---|---|
<PropertyDataSet> | Optional* | <PropertyDataSet> |
किसी खास कमरे और रूम बंडल के बारे में बताता है. आप आम तौर पर इसका इस्तेमाल करते/करती हैं एलिमेंट जोड़ा गया है, ताकि शेयर की गई वैल्यू तय की जा सके रूम बंडल खरीदने और लेन-देन के मैसेज का साइज़ कम करने के लिए. |
<Result> | Optional* | <Result> |
कमरे की यात्रा की योजना के लिए कीमत का डेटा या
|
* <PropertyDataSet> या <Result> में से कम से कम एक
आवश्यक है. |
उदाहरण
रूम का डेटा
नीचे दिए गए उदाहरण में, लेन-देन के मैसेज में कमरे के डेटा के बारे में बताया गया है:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>5440OF</RoomID>
<Name>
<Text text="Single King Bed Room" language="en"/>
<Text text="Simple Lit de Roi" language="fr"/>
</Name>
<Description>
<Text text="One king bed with pillowtop mattresses, 300-thread-count linens,
and down comforters (bedspreads). City view. 300 square feet. Desk with
rolling chair. Multi-line phone with voice mail. Cable/satellite TV with
complimentary HBO and pay movies." language="en"/>
<Text text="Un très grand lit avec matelas à plateau-coussin, ..." language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Bathroom View" language="en"/>
<Text text="La salle de baines" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Capacity>4</Capacity>
</RoomData>
</PropertyDataSet>
</Transaction>
कीमत का डेटा
इस उदाहरण में, लेन-देन वाले मैसेज में कीमत के डेटा के बारे में बताया गया है:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">278.33</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="site1"/>
</AllowablePointsOfSale>
</Result>
<Result>
<Property>052213</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">299.98</Baserate>
<Tax currency="USD">26.42</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="otto"/>
<PointOfSale id="simon"/>
</AllowablePointsOfSale>
</Result>
</Transaction>
एक रात का किराया
नीचे दिए गए उदाहरण में, एक से सात रातों की शुरुआत के लिए किराये का डेटा बताया गया है 7 जून, 2023:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-08-24T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">209.99</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">419.98</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>3</Nights>
<Baserate currency="USD">614.97</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>4</Nights>
<Baserate currency="USD">819.96</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>5</Nights>
<Baserate currency="USD">999.95</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>6</Nights>
<Baserate currency="USD">1193.94</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>7</Nights>
<Baserate currency="USD">1259.93</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
</Transaction>
बेस और खास किराया
इस उदाहरण में, लेन-देन का एक मैसेज दिखाया गया है, जिसमें बेस शामिल है दर और खास दर:
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">200.00</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<Rates>
<!-- The rate_rule_id is required when using conditional rates -->
<Rate rate_rule_id="mobile">
<!-- Override base rate and taxes for conditional rates -->
<Baserate currency="USD">180.00</Baserate>
<Tax currency="USD">18.00</Tax>
<!-- NOTE: OtherFees is inherited from the above setting -->
<Custom1>ratecode123</Custom1>
</Rate>
</Rates>
</Result>
</Transaction>
इन्वेंट्री हटाएं
इस उदाहरण में, कई इन्वेंट्री हटाई गई हैं (एक रात ठहरने के लिए कई अलग-अलग तारीखें) के आधार पर दिखाया जाता है:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-05-23T16:20:00-04:00" id="42">
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-23</Checkin>
<Nights>1</Nights>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-24</Checkin>
<Nights>1</Nights>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
<!---Sending <Baserate> is optional with <Unavailable> -->
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-25</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">-1</Baserate>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
</Transaction>
<PropertyDataSet>
कंटेनर में कमरे और पैकेज (या कमरे के बंडल) की जानकारी के लिए
<Transaction>
मैसेज. किसी होटल पर सेट की गई वैल्यू, पार्टनर पर सेट की गई वैल्यू को बदलती हैं.
Google यह जानकारी सेव करता है, ताकि आपको हर बार जानकारी देने की ज़रूरत न पड़े
तो आप कीमतों के बारे में अपडेट भेजते हैं.
<PropertyDataSet>
एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है
लेन-देन के मैसेज की एक्सएमएल हैरारकी:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
ज़्यादा जानकारी के लिए, रूम बंडल मेटाडेटा देखें.
सिंटैक्स
<PropertyDataSet>
एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <PropertyDataSet> <!-- (Required) ID that matches the Hotel List Feed --> <Property>hotel_ID</Property> <!-- (Optional) Defines metadata about a room --> <RoomData> ... </RoomData> <!-- (Optional) Defines package metadata to be paired with rooms (Room Bundles) --> <PackageData> ... </PackageData> </PropertyDataSet> ... </Transaction>
विशेषताएं
<PropertyDataSet>
एलिमेंट में कोई एट्रिब्यूट नहीं है.
चाइल्ड एलीमेंट
<PropertyDataSet>
एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:
चाइल्ड एलिमेंट | ज़रूरी है? | टाइप | ब्यौरा |
---|---|---|---|
<PackageData> | Optional* | <PackageData> |
रूम बंडल के बारे में बताता है. यह डेटा किसी पार्टनर से जुड़ा है और
होटल शामिल है, लेकिन यात्रा की योजना के साथ नहीं. यह एलिमेंट इसके जैसा है
<RoomData> , लेकिन इसमें उन सुविधाओं और शर्तों के बारे में बताया गया है जो इसमें शामिल नहीं हैं
कमरे के ब्यौरे में शामिल किया गया है.
कीमत के अपडेट में, पैकेज आईडी का रेफ़रंस दिया जाता है. ज़्यादा जानकारी के लिए, इसे देखें रूम बंडल का मेटाडेटा. |
<Property> | Required | string | उस होटल का आईडी जिससे जुड़ा हुआ डेटा लागू होता है. कॉन्टेंट बनाने
इस एलिमेंट का मान एक ऐसी स्ट्रिंग होनी चाहिए जो स्टोर पेज से मेल खाती हो
<id> आपके होटल सूची फ़ीड में.
|
<RoomData> | Optional* | <RoomData> |
रूम के बारे में बताता है. यह डेटा किसी पार्टनर और होटल से जुड़ा है,
लेकिन यात्रा की योजना के साथ नहीं.
आपने किराये के अपडेट में, रूम आईडी का रेफ़रंस दिया हो. |
* <PackageData> या <RoomData> में से कम से कम एक
आवश्यक है. |
उदाहरण
कमरे और पैकेज का डेटा
नीचे दिए गए उदाहरण में रूम और पैकेज, दोनों का डेटा
<PropertyDataSet>
:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>180054</Property>
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Bed Room" language="en"/>
<Text text="Chambre single" language="fr"/>
</Name>
<Description>
<Text text="Non-smoking" language="en"/>
<Text text="Pas de fumiers" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Includes a delightful array of jams and jellies." language="en"/>
<Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
इस कमरे और रूम बंडल के किराये और उपलब्धता की जानकारी भेजने पर, कीमत बताने वाले मैसेज में कमरे और पैकेज आईडी का रेफ़रंस दें. इसका नतीजा यह है कि आप अपने संदेशों का आकार बहुत अधिक घटा सकते हैं, और साथ ही डुप्लीकेट डेटा की वजह से आपको कितनी गड़बड़ियां मिल सकती हैं. ज़्यादा के लिए रूम बंडल मेटाडेटा देखें.
<RoomData>
इससे, कमरों की जानकारी, यात्रा की योजना, और एक्सटेंशन की मदद से अलग-अलग कमरों की जानकारी मिलती है
बंडल (कमरों के बंडल में कमरे और दूसरी सुविधाएं शामिल होती हैं). इस्तेमाल की जाने वाली चीज़ें
कीमत में जानकारी देने वाले डेटा का दोहराव कम करने के लिए, <RoomData>
फ़ीड.
<RoomData>
एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है
लेन-देन के मैसेज की एक्सएमएल हैरारकी:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
<RoomData>
एलिमेंट में ऐसी जानकारी शामिल है जो किसी
पार्टनर और होटल के लिए बुकिंग करना होगा, लेकिन यात्रा की योजना के साथ नहीं. सही मकसद सभी के लिए है
सामान्य डेटा.
<RoomData>
एलिमेंट, <PackageData>
की तरह है, लेकिन यह इसके बारे में बताता है
जैसी सुविधाओं और पैकेज की शर्तों को पूरा करने की ज़रूरत नहीं होती. आप उपयोग करते हैं
<RoomData>
और <PackageData>
को मिलाकर, इस बारे में जानकारी दें
कमरों के बंडल. जो अलग-अलग कमरे किसी पैकेज में शामिल नहीं हैं उनके लिए, सिर्फ़
<RoomData>
.
इसके लिए <RoomData>
और <PackageData>
, दोनों एलिमेंट को तय किया जा सकता है
एक ही कमरे या अलग-अलग कमरे. जब Google उस कमरे या पैकेज को
खोज परिणामों में शामिल होंगे, तो इसमें दोनों के वर्णन शामिल होंगे, जो
हाइफ़न.
ज़्यादा जानकारी के लिए, रूम बंडल मेटाडेटा देखें.
सिंटैक्स
<RoomData>
एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <PropertyDataSet> ... <RoomData> <RoomID>room_ID</RoomID> <Name> <Text text="room_name" language="language_code"/> ... </Name> <Description> <Text text="room_description" language="language_code"/> ... </Description> <Capacity>max_number_of_occupants</Capacity> <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <!-- optional info about the types of guests, whether adults, children, or seniors --></OccupancyDetails> <OccupancySettings> <MinOccupancy>min_number_of_occupants</MinOccupancy> <MinAge>min_age_of_occupants</MinAge> </OccupancySettings> <PhotoURL> <Caption> <Text text="photo_description" language="language_code"/> ... </Caption> <URL>photo_location</URL> </PhotoURL> <RoomFeatures> ... </RoomFeatures> </RoomData> ... </PropertyDataSet> </Transaction>
विशेषताएं
<RoomData>
एलिमेंट में कोई एट्रिब्यूट नहीं है.
चाइल्ड एलीमेंट
<RoomData>
एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:
चाइल्ड एलिमेंट | ज़रूरी है? | टाइप | ब्यौरा |
---|---|---|---|
<Capacity> | Optional | integer | उन मेहमानों की ज़्यादा से ज़्यादा संख्या जो एक कमरे में थक सकते हैं
जगह की जानकारी. किसी कमरे की क्षमता इससे ज़्यादा या इसके बराबर है
बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या.
तय किए जाने पर, यह मान, मान के बराबर या उससे ज़्यादा होना चाहिए
|
<Description> | Optional | Object | कमरे के बारे में पूरी जानकारी. इस एलिमेंट को ऐसा करना चाहिए
उसमें ऐसी जानकारी शामिल हो जिसे अन्य एलिमेंट या
<Name> एलिमेंट. आपको पूरी पूंजी का इस्तेमाल नहीं करना चाहिए
कमरे का विवरण तय करते समय अक्षरों का इस्तेमाल करें.
हर भाषा के लिए अलग नीचे दिए गए उदाहरण में, रूम के फ़्रेंच और अंग्रेज़ी वर्शन दिखाए गए हैं विवरण: <Description> <Text text="Two queen-sized beds" language="en"/> <Text text="Deux lits de la reine" language="fr"/> </Description> |
<Name> | Required | string | रूम की कैटगरी का नाम. यह मान इससे मेल खाना चाहिए:
होटल के लैंडिंग पेज पर दिखाई देता है (पहले बिक्री की जगह था). सेट न करें
सभी बड़े अक्षरों में इस एलिमेंट की वैल्यू डालें.
इस एलिमेंट को
हर भाषा के लिए अलग नीचे दिए गए उदाहरण में, रूम के फ़्रेंच और अंग्रेज़ी वर्शन दिखाए गए हैं नाम: <Name> <Text text="Standard Double Room" language="en"/> <Text text="Le chambre double" language="fr"/> </Name> |
<Occupancy> | Optional | integer | ज़्यादा से ज़्यादा मेहमानों की संख्या जिनके लिए कमरा बुक किया गया है.
उदाहरण के लिए, एक बड़ा सुइट छह
मेहमान (क्षमता = 6), लेकिन यह ज़्यादा से ज़्यादा 4 मेहमानों के लिए है.
यह मान इससे कम या इसके बराबर होना चाहिए:
|
<OccupancySettings> | Optional | Object | ऐसी सेटिंग जो किसी
कमरा.
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> सभी चाइल्ड एलिमेंट शामिल करना ज़रूरी नहीं है. |
<PhotoURL> | Optional | Object | दिए गए कमरे की फ़ोटो का यूआरएल और वैकल्पिक कैप्शन या
अलग-अलग कमरों का बंडल. एक से ज़्यादा <PhotoURL> दिए जा सकते हैं
एक कमरे या अलग-अलग कमरे के बंडल के लिए. हर फ़ोटो का यूआरएल उसका अपना होना चाहिए
<PhotoURL> .
इस एलिमेंट में ये चाइल्ड एलिमेंट शामिल होते हैं:
उदाहरण: <PhotoURL> <URL>https://www.example.com/static/bar/image1234.jpg</URL> <Caption> <Text text="A bright and breezy way to enjoy your mornin' cuppa tea." language="en"/> <Text text="Une façon lumineuse et aérée pour profiter de votre journée tasse de thé." language="fr"/> </Caption> </PhotoURL> <PhotoURL> <URL>https://www.foo.com/static/bar/image5678.jpg</URL> <Caption> <Text text="Or, perhaps you prefer coffee." language="en"/> <Text text="Ou peut-être préférez-vous le café." language="fr"/> </Caption> </PhotoURL> |
<RoomFeatures> | Optional | <RoomFeatures> |
इसमें कमरे की सुविधाओं के बारे में जानकारी होती है. |
<RoomID> | Required | string | रूम का यूनीक आईडी. कमरे के डेटा से मिलान करने के लिए इस आईडी का इस्तेमाल करें
आपको कीमत के अपडेट में, <Result> ब्लॉक को शामिल करना होगा. इसके लिए
ज़्यादा जानकारी के लिए, रूम बंडल मेटाडेटा देखें. (आप
इस आईडी का इस्तेमाल किसी सिंगल रूम की कॉमन डेफ़िनिशन के बारे में बताने के लिए भी किया जा सकता है
रूम के डेटा को इनलाइन तय करते समय लेन-देन की जानकारी देने वाला मैसेज दिखेगा.) |
उदाहरण
रूम का डेटा
नीचे दिए गए उदाहरण में कमरे के डेटा के बारे में बताया गया है:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>5440OF</RoomID>
<Name>
<Text text="Single King Bed Room" language="en"/>
<Text text="Simple Lit de Roi" language="fr"/>
</Name>
<Description>
<Text text="One king bed with pillowtop mattresses, 300-thread-count linens,
and down comforters (bedspreads). City view. 300 square feet. Desk with
rolling chair. Multi-line phone with voice mail. Cable/satellite TV with
complimentary HBO and pay movies." language="en"/>
<Text text="Un très grand lit avec matelas à plateau-coussin, ..." language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Bathroom View" language="en"/>
<Text text="La salle de baines" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Capacity>4</Capacity>
</RoomData>
</PropertyDataSet>
</Transaction>
कमरा और पैकेज मेटाडेटा
इस उदाहरण में कमरे और पैकेज के मेटाडेटा के बारे में बताया गया है:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>180054</Property>
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Bed Room" language="en"/>
<Text text="Chambre single" language="fr"/>
</Name>
<Description>
<Text text="Non-smoking" language="en"/>
<Text text="Pas de fumiers" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Includes a delightful array of jams and jellies." language="en"/>
<Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
कई कमरों के बंडल
इस उदाहरण में एक से ज़्यादा कमरे के लिए, कमरे और पैकेज के मेटाडेटा के बारे में बताया गया है बंडल:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<!-- A transaction message with room types result. -->
<PropertyDataSet>
<Property>12345</Property>
<RoomData>
<RoomID>single</RoomID>
<Name>
<Text text="Single room" language="en"/>
<Text text="Chambre simple" language="fr"/>
</Name>
<Description>
<Text text="A single room" language="en"/>
<Text text="Le chambre simple" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<PhotoURL>
<URL>http://www.foo.com/static/bar/image1235.jpg</URL>
</PhotoURL>
<Capacity>2</Capacity>
</RoomData>
<RoomData>
<RoomID>double</RoomID>
<Name>
<Text text="Double room" language="en"/>
<Text text="Chambre double" language="fr"/>
</Name>
<Occupancy>1</Occupancy>
</RoomData>
<PackageData>
<PackageID>refundbreakfast</PackageID>
<Name>
<Text text="Refundable Room with Breakfast" language="en"/>
<Text text="Chambre remboursable avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Continental Breakfast" language="en"/>
<Text text="Petit déjeuner continental" language="fr"/>
</Description>
<ChargeCurrency>hotel</ChargeCurrency>
<Refundable available="1" refundable_until_days="3"/>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
<PackageData>
<PackageID>prepaid</PackageID>
<Name>
<Text text="Nonrefundable" language="en"/>
<Text text="Non remboursable" language="fr"/>
</Name>
<Description>
<Text text="Blah blah blad" language="en"/>
<Text text="Le blah blah blad" language="fr"/>
</Description>
<Occupancy>2</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="0"/>
</PackageData>
</PropertyDataSet>
</Transaction>
<RoomFeatures>
यह रूम में मिलने वाली सुविधाओं के बारे में बताता है.
<RoomFeatures>
एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है
लेन-देन के मैसेज की एक्सएमएल हैरारकी:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<RoomFeatures>
सिंटैक्स
<RoomFeatures>
एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <PropertyDataSet ... > ... <RoomData> <RoomFeatures> <JapaneseHotelRoomStyle>[western|japanese|japanese_western]</JapaneseHotelRoomStyle> <Beds> <Bed size="[single|semi_double|double|queen|king]"> <Width unit="cm" number="width"/> <Length unit="cm" number="length"/> </Bed> <!-- Include with any additional beds. --> </Beds> <Suite/> <Capsule/> <Roomsharing>[shared|private]</Roomsharing> <Outdoor/> <MobilityAccessible/> <Smoking>[smoking|non_smoking]</Smoking> <BathAndToilet relation="[together|separate]"> <Bath bathtub="[false|true]" shower="[false|true]"/> <Toilet electronic_bidet="[false|true]" mobility_accessible="[false|true]"/> </BathAndToilet> <OpenAirBath/> <AirConditioning/> <Balcony/> <Views> <!-- (Optional) Defines the type of views from the room. --> <!-- Example: <OceanView/> --> </Views> </RoomFeatures> ... </RoomData> ... </PropertyDataSet> </Transactions>
विशेषताएं
<RoomFeatures>
एलिमेंट में कोई एट्रिब्यूट नहीं है.
चाइल्ड एलीमेंट
<RoomFeatures>
एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:
चाइल्ड एलिमेंट | ज़रूरी है? | टाइप | ब्यौरा |
---|---|---|---|
<JapaneseHotelRoomStyle> | Optional | enum | जैपनीज़ होटल के कमरे की शैली को दिखाता है. मान्य मान हैं:
|
<Beds> | Optional | Object | रूम में ज़्यादा से ज़्यादा <Bed> शामिल हैं. नोट जोड़ें
कि यहां जापानी फ़ुटॉन की गिनती नहीं की जानी चाहिए.
हर
<Bed> में ये चाइल्ड एलिमेंट होते हैं:
<Beds> <Bed size="double"> <Width unit="cm" number="140"/> <Length unit="cm" number="195"/> </Bed> <Bed/> <!-- Size unknown --> </Beds> |
<Suite> | Optional | empty | अगर यह कमरा, सुइट है, तो इस एलिमेंट का इस्तेमाल करें. |
<Capsule> | Optional | empty | यह एलिमेंट तब दिखाएं, जब यह रूम कैप्सूल रूम हो. |
<Roomsharing> | Optional | enum | क्या यह कमरा बुक करने वाले लोगों के साथ शेयर किया गया है, जैसे कि मालिक या दूसरे लोग
मेहमान. मान्य वैल्यू, shared और private हैं. |
<Outdoor> | Optional | empty | यह एलिमेंट तब दिखाएं, जब यह कमरा बाहर की ओर से हो रहा हो प्लंबिंग, और जलवायु को कंट्रोल करने की सुविधाएं मौजूद हैं. उदाहरण के लिए, होटल के कमरे आउटडोर आवास नहीं हैं जबकि कैंपसाइट जहां मेहमान टेंट में रहते हैं और रीक्रिएशनल व्हीकल पार्क, जहां मेहमान खुद का आरवी लाएंगे. यहां ठहरने के लिए बाहर की जगह भी इस्तेमाल की जा सकती है. |
<MobilityAccessible> | Optional | empty | यह एलिमेंट तब दिखाएं, जब इस कमरे में आने-जाने के लिए व्हीलचेयर ले जाने की सुविधा हो. |
<Smoking> | Optional | enum | क्या इस कमरे में धूम्रपान करना मना है या धूम्रपान करना मना है. मान्य वैल्यू
non_smoking और smoking हैं. |
<BathAndToilet> | Optional | Object | इसमें कमरे में नहाने और शौचालय के बारे में जानकारी है.
एट्रिब्यूट है:
वैकल्पिक रूप से, ये एलिमेंट इन चाइल्ड एलिमेंट को भी शामिल करते हैं:
उदाहरण: <BathAndToilet relation="separate"> <Bath bathtub="1" shower="1"/> <Toilet electronic_bidet="1" mobility_accessible="1"/> </BathAndToilet> |
<OpenAirBath> | Optional | empty | यह एलिमेंट तब दें, जब इस कमरे में खुले में निजी बाथरूम की सुविधा हो. |
<AirConditioning> | Optional | empty | अगर इस कमरे में एयर कंडिशनिंग की सुविधा है, तो इस एलिमेंट का इस्तेमाल करें. |
<Balcony> | Optional | empty | अगर इस कमरे में बालकनी या लैनाई (बरामदे जैसी जगह) है, तो इस एलिमेंट का इस्तेमाल करें. |
<Views> | Optional | Object | मान्य विकल्पों में ये शामिल हैं:
|
उदाहरण
JapaneseHotelRoomStyle
की कोई डिफ़ॉल्ट वैल्यू नहीं है. हटाया जा रहा है
मान के कारण कोई XML गड़बड़ी नहीं मिलती है, लेकिन आपकी लिस्टिंग इसमें नहीं दिखाई जाती है
तब खोज के नतीजे दिखाए जाते हैं, जब उपयोगकर्ता कमरे की स्टाइल या बेड के हिसाब से फ़िल्टर करता है.
दो सिंगल बेड
नीचे दिए गए उदाहरण में, <RoomFeatures>
को इस्तेमाल करने का तरीका बताया गया है:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
<Beds> <!-- Two single beds -->
<Bed size="single">
<Width unit="cm" number="97"/>
<Length unit="cm" number="195"/>
</Bed>
<Bed size="single">
<Width unit="cm" number="97"/>
<Length unit="cm" number="195"/>
</Bed>
</Beds>
<Suite/>
<Capsule/>
<Roomsharing>private</Roomsharing>
<Outdoor/>
<MobilityAccessible/>
<Smoking>non_smoking</Smoking>
<BathAndToilet relation="separate">
<Bath bathtub="1" shower="1"/>
<Toilet electronic_bidet="1" mobility_accessible="1"/>
</BathAndToilet>
<OpenAirBath/>
<AirConditioning/>
<Balcony/>
<Views>
<LakeView/>
<MarinaView/>
<BeachView/>
<ForestView/>
<MountainView/>
<NatureView/>
</Views>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
दो डबल बेड
यहां western
स्टाइल वाले जैपनीज़ रूम का उदाहरण दिया गया है, जिसमें दो कमरे हैं
double
बेड.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
<Beds> <!-- Two double beds-->
<Bed size="double"></Bed>
<Bed size="double"></Bed>
</Beds>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
बिना बेड के जैपनीज़ स्टाइल
यहां बिना बिस्तर वाले जैपनीज़ शैली के कमरे का उदाहरण दिया गया है. बेड
japanese
स्टाइल रूम के लिए, जानकारी की ज़रूरत नहीं है.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese</JapaneseHotelRoomStyle>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
बिस्तर के साथ जैपनीज़ वेस्टर्न
यहां king
के साथ japanese_western
स्टाइल रूम का उदाहरण दिया गया है
साइज़ बेड.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
<Beds>
<Bed size="king"></Bed>
</Beds>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
अगर पार्टनर को japanese_western
में बेड की संख्या की जानकारी नहीं है
कमरों पर जाएं, तो उदाहरण देखें:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
<PackageData>
किसी प्रॉपर्टी के लिए, कमरे के बंडल के बारे में अलग-अलग मेटाडेटा के बारे में बताता है. यह मेटाडेटा, यात्रा की योजना से अलग होता है. इस एलिमेंट में पार्टनर और होटल से जुड़ी जानकारी शामिल होती है, लेकिन यात्रा की योजना के साथ नहीं. इसका मकसद यह बताना है कि यात्रा कैसे शुरू करें डेटा को सिर्फ़ यात्रा की योजना के डेटा से देख लें.
<PackageData>
एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है
लेन-देन के मैसेज की एक्सएमएल हैरारकी:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
<PackageData>
एलिमेंट, <RoomData>
की तरह है, लेकिन यह
उन सुविधाओं और शर्तों के बारे में बताता है जो इस कमरे का हिस्सा नहीं हैं
ब्यौरा. <RoomData>
और <PackageData>
, दोनों का इस्तेमाल इन कामों के लिए किया जाता है
रूम बंडल और किराये की सुविधाओं के बारे में जानकारी देती हो. ऐसे अलग-अलग कमरों के लिए
किसी पैकेज का हिस्सा नहीं हैं, सिर्फ़ <RoomData>
का इस्तेमाल करें.
आप इसके लिए <RoomData>
और <PackageData>
दोनों एलिमेंट तय कर सकते हैं:
एक ही कमरे या बंडल में. जब Google उस कमरे या पैकेज को
खोज परिणामों में, इसमें दोनों के वर्णन शामिल होंगे, जो
हाइफ़न.
अगर आप किसी प्रॉपर्टी के लिए एक ही <PackageData>
एलिमेंट को अपडेट करते हैं, तो आपको ये काम ज़रूर करने चाहिए
प्रॉपर्टी के लिए सभी <PackageData>
और <RoomData>
एलिमेंट अपडेट करें.
हर <PropertyDataSet>
को प्रॉपर्टी का पूरा डेटा माना जाता है और
किसी मौजूदा डेटा को ओवरराइट कर देता है.
ज़्यादा जानकारी के लिए, रूम बंडल मेटाडेटा देखें.
सिंटैक्स
<PackageData>
एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
<PropertyDataSet ... >
<PackageData>
<PackageID>package_ID</PackageID>
<Name>
<Text text="package_name" language="language_code"/>
...
</Name>
<Description>
<Text text="package_description" language="language_code"/>
...
</Description>
<Refundable available="[false|true]" refundable_until_days="number_of_days"
refundable_until_time="time"/>
<ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency>
<Occupancy>max_number_of_intended_occupants</Occupancy>
<OccupancyDetails><!-- optional info about the types of guests,
whether adults or children --></OccupancyDetails>
<!-- For these next 3 elements, boolean_value can be 0/1 or true/false -->
<BreakfastIncluded>boolean_value</BreakfastIncluded>
<InternetIncluded>boolean_value</InternetIncluded>
<ParkingIncluded>boolean_value</ParkingIncluded>
<PhotoURL>
<Caption>
<Text text="photo_description" language="language_code"/>
...
</Caption>
<URL>photo_location</URL>
</PhotoURL>
...
<Meals>
<Breakfast
included="[true|false]" buffet="[true|false]"
in_room="[true|false]" in_private_space="[true|false]"/>
<Dinner
included="[true|false]" buffet="[true|false]"
in_room="[true|false]" in_private_space="[true|false]"/>
</Meals>
<CheckinTime>checkin_time</CheckinTime>
<CheckoutTime>checkout_time</CheckoutTime>
<MembershipBenefitsIncluded>
<ProgramName>
<Text language="en" text="Special Rewards">
</ProgramName>
<ProgramLevel>
<Text language="en" text="Platinum">
</ProgramLevel>
</MembershipBenefitsIncluded>
<OnPropertyCredit>
<Amount currency="USD">123.45</Amount>
</OnPropertyCredit>
</PackageData>
<!-- a PackageID with a MilesIncluded
rate feature -->
<PackageData>
<PackageID>room_with_miles</PackageID>
<Name>
<Text text="Room with Bundled Miles" language="en">
</Name>
<ChargeCurrency>hotel </ChargeCurrency>
<MilesIncluded>
<NumberOfMiles>1000 </NumberOfMiles>
<Provider>
<Text language="en" text="United Airlines">
</Provider>
</MilesIncluded>
</PackageData>
...
...
</PropertyDataSet>
...
</Transaction>
विशेषताएं
<PackageData>
एलिमेंट में कोई एट्रिब्यूट नहीं है.
चाइल्ड एलीमेंट
<PackageData>
एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:
चाइल्ड एलिमेंट | ज़रूरी है? | टाइप | ब्यौरा |
---|---|---|---|
<BreakfastIncluded> | Optional | boolean | इससे पता चलता है कि इस पैकेज में, किराये के साथ नाश्ता शामिल है या नहीं.
मान्य मान 0 (या false ) और 1 हैं
(या true ).
बेहतर होगा कि आप
इसके बजाय |
<ChargeCurrency> | Optional | enum | उपयोगकर्ता बुकिंग के लिए कब और कहां पैसे चुकाता है. यह एलिमेंट उसी यूआरएल का इस्तेमाल करता है
<Result> में <ChargeCurrency> के रूप में सिंटैक्स.
डिफ़ॉल्ट वैल्यू |
<CheckinTime> | Optional | Time | चेक-इन करने का जल्द से जल्द समय. होटल के स्थानीय समय के हिसाब से, समय 24:00 से कम होना चाहिए. |
<CheckoutTime> | Optional | Time | होटल के स्थानीय समय के हिसाब से, चेक-आउट करने का सबसे हाल का समय. |
<Description> | Optional | Object | पैकेज के बारे में ज़्यादा जानकारी. इस एलिमेंट को ऐसा करना चाहिए
उसमें ऐसी जानकारी शामिल हो जिसे अन्य एलिमेंट या
<Name> एलिमेंट. आपको पूरी पूंजी का इस्तेमाल नहीं करना चाहिए
कमरे का विवरण तय करते समय अक्षरों का इस्तेमाल करें.
<Description> <Text text="Two breakfast buffet certificates for each night of stay." language="en"/> <Text text="Deux certificats petit-déjeuner buffet pour chaque nuit de séjour." language="fr"/> </Description> |
<InternetIncluded> | Optional | boolean | अगर किसी पैकेज में बिना किसी शुल्क के इंटरनेट ऐक्सेस शामिल है,
जबकि अन्य पैकेज में वह सुविधा शामिल नहीं होगी. इसे सेट न करें
होटल के उस होटल के रूम बंडल में इस्तेमाल होने वाले एलिमेंट जो मुफ़्त इंटरनेट की सुविधा देते हैं
कमरे. यह एलिमेंट, कमरे में वायर वाले इंटरनेट या वायरलेस इंटरनेट कनेक्शन पर लागू नहीं होता
जो कमरों में उपलब्ध नहीं है. मान्य मान ये हैं
0 (या false ) और 1
(या true ).
|
<Meals> | Optional | Object | इस पैकेज में खाने के बारे में जानकारी होती है.
वैकल्पिक विशेषताओं का इस्तेमाल सिर्फ़ तब किया जाता है, जब मील फ़िल्टर ( |
<Name> | Required | string | पैकेज का नाम. यह वैल्यू,
होटल का लैंडिंग पेज. इस एलिमेंट की वैल्यू को पूरी तरह से कैपिटल पर सेट न करें
अंग्रेज़ी वर्णमाला के छोटे अक्षर दिखाएं.
इस एलिमेंट को <Name> <Text text="Bed and Breakfast" language="en"/> <Text text="Lit et petit déjeuné" language="fr"/> </Name> |
<Occupancy> | Optional | integer | ज़्यादा से ज़्यादा इतने मेहमानों की संख्या जिनके लिए कमरे का बंडल बनाया गया है.
उदाहरण के लिए, एक बड़ा सुइट छह
यह ज़्यादा से ज़्यादा चार लोगों के लिए है.
यह मान इससे कम या इसके बराबर होना चाहिए:
अगर इस एलिमेंट को ध्यान दें: <Occupancy> के साथ शायद
<OccupancyDetails> ,यह दिखाता है कि मेहमान किस तरह के हैं
(वयस्क या बच्चे). सिंटैक्स के लिए <OccupancyDetails> देखें और
चाइल्ड एलिमेंट की जानकारी.
|
<PackageID> | Required | string | पैकेज का यूनीक आईडी. इस आईडी का इस्तेमाल
आपके स्पेस में (आप इस आईडी का इस्तेमाल, रूम बंडल की सामान्य परिभाषा बताने के लिए भी कर सकते हैं रूम बंडल डेटा तय करते समय एक ही लेन-देन मैसेज में इस्तेमाल किया गया inline.) |
<ParkingIncluded> | Optional | boolean | रूम बंडल में बिना किसी शुल्क के पार्किंग शामिल है या नहीं,
अगर ऐसा नहीं है, तो इस होटल में पार्किंग की सुविधा के लिए पैसे चुकाने होंगे. जानकारी न दें
मुफ़्त पार्किंग की सुविधा देने वाले होटल के लिए इस एलिमेंट का मान.
मान्य वैल्यू |
<PhotoURL> | Optional | Object | (<RoomData> में <PhotoURL> की तरह,
लेकिन पैकेज (जैसे कि खाने की फ़ोटो) के लिए.
|
<Refundable> | Optional | Object | इससे किराये की जानकारी को पूरा रिफ़ंड या मुफ़्त उपलब्ध कराने के तौर पर लिस्ट किया जाता है
रद्द करने की प्रक्रिया. अगर यह जानकारी नहीं दी जाती है, तो रिफ़ंड के बारे में कोई जानकारी नहीं दिखाई जाएगी.
<PackageData> के लेवल पर रिफ़ंड नीति, रिफ़ंड नीति की जगह लागू हो जाती है
<Result> लेवल. <Rates> लेवल पर रिफ़ंड नीति में बदलाव
रिफ़ंड नीति को <PackageData> के लेवल पर सबमिट करें. रिफ़ंड की जा सकने वाली कीमत
उपयोगकर्ताओं के लिए, सीधे तौर पर नहीं दिए गए अन्य विकल्पों की मदद से भी उन्हें हाइलाइट किया जाएगा
ट्रांज़ैक्शन मैसेज के स्कीमा में बदलाव किया जा रहा है. इन विकल्पों के बारे में ज़्यादा जानें
किराये के रिफ़ंड के लिए बनी नीति.
यहां दिए गए उदाहरण में, <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> ध्यान दें: हमारा सुझाव है कि आप सभी एट्रिब्यूट को सेट करें. एक फ़ीड स्थिति के बारे में चेतावनी देने वाला मैसेज तब जनरेट होता है, जब एक या उससे ज़्यादा एट्रिब्यूट सेट नहीं है. अगर आपने कोई एट्रिब्यूट सेट नहीं किया है, तो दर इस तरह नहीं दिखती है रिफ़ंड किया जा सकता है. एट्रिब्यूट:
एट्रिब्यूट सेट करते समय, इन बातों का ध्यान रखें:
|
<MembershipBenefits |
Optional | boolean | किराये में ठहरने के दौरान मिलने वाले खास स्टेटस के फ़ायदे शामिल हैं. इसमें शामिल है
नीचे दिए पैरामीटर:
|
<CarRentalIncluded> | Optional | boolean | इस किराये में, ठहरने के दौरान किराये पर कार लेने की सुविधा भी शामिल है. |
<MilesIncluded>> | Optional | boolean | दर में नियमित हवाई यात्री मील शामिल हैं. इनमें ये पैरामीटर शामिल हैं:
|
<OnPropertyCredit> | Optional | boolean | किराये में प्रॉपर्टी के लिए क्रेडिट कार्ड शामिल हैं. जैसे, खाने-पीने की चीज़ें, रिज़ॉर्ट, स्पा वगैरह. पैरामीटर:
|
<AirportTransportationIncluded> | Optional | Object | आस-पास के हवाई अड्डे से आने-जाने के लिए परिवहन मुफ़्त है. वैकल्पिक
direction एट्रिब्यूट, निर्देश देने के लिए
परिवहन. मान्य वैल्यू में ये शामिल हैं:
from : हवाई अड्डे से
प्रॉपर्टी. अगर कोई निर्देश नहीं दिया गया है, तो यह डिफ़ॉल्ट वैल्यू होती है.
to : हवाई अड्डे से परिवहन की सुविधा दी जाती है
प्रॉपर्टी.
round_trip :
हवाई अड्डा.
|
उदाहरण
एक कमरे वाले बंडल
नीचे दिए गए उदाहरण में, एक कमरे के बंडल के बारे में बताया गया है, जिसमें बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या 2 (एक वयस्क और एक बच्चा) और नाश्ते में ये शामिल हैं:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<PackageData>
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>1</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Two certificates for continental
breakfast will be provided." language="en"/>
<Text text="Deux certificats pour le petit déjeuner
continental seront fournis." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
कमरे और पैकेज का मेटाडेटा
इस उदाहरण में कमरे और पैकेज के मेटाडेटा के बारे में बताया गया है:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>180054</Property>
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Bed Room" language="en"/>
<Text text="Chambre single" language="fr"/>
</Name>
<Description>
<Text text="Non-smoking" language="en"/>
<Text text="Pas de fumiers" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Includes a delightful array of jams and jellies." language="en"/>
<Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
कई कमरों के बंडल
इस उदाहरण में एक से ज़्यादा कमरे के लिए, कमरे और पैकेज के मेटाडेटा के बारे में बताया गया है बंडल:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<!-- A transaction message with room types result. -->
<PropertyDataSet>
<Property>12345</Property>
<RoomData>
<RoomID>single</RoomID>
<Name>
<Text text="Single room" language="en"/>
<Text text="Chambre simple" language="fr"/>
</Name>
<Description>
<Text text="A single room" language="en"/>
<Text text="Le chambre simple" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<PhotoURL>
<URL>http://www.foo.com/static/bar/image1235.jpg</URL>
</PhotoURL>
<Capacity>2</Capacity>
</RoomData>
<RoomData>
<RoomID>double</RoomID>
<Name>
<Text text="Double room" language="en"/>
<Text text="Chambre double" language="fr"/>
</Name>
<Occupancy>1</Occupancy>
</RoomData>
<PackageData>
<PackageID>refundbreakfast</PackageID>
<Name>
<Text text="Refundable Room with Breakfast" language="en"/>
<Text text="Chambre remboursable avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Continental Breakfast" language="en"/>
<Text text="Petit déjeuner continental" language="fr"/>
</Description>
<ChargeCurrency>hotel</ChargeCurrency>
<Refundable available="1" refundable_until_days="3"/>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
<PackageData>
<PackageID>prepaid</PackageID>
<Name>
<Text text="Nonrefundable" language="en"/>
<Text text="Non remboursable" language="fr"/>
</Name>
<Description>
<Text text="Blah blah blad" language="en"/>
<Text text="Le blah blah blad" language="fr"/>
</Description>
<Occupancy>2</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="0"/>
</PackageData>
</PropertyDataSet>
</Transaction>
दरों के साथ कमरों का बंडल
इस उदाहरण में रूम बंडल के लिए, कमरे और पैकेज के मेटाडेटा के बारे में बताया गया है दर की सुविधाओं के साथ:
<Transaction timestamp="2010-04-24T20:44:56-04:00" id="TXNID">
<PropertyDataSet>
<Property>12345</Property>
<RoomData>
...
</RoomData>
<!-- definitions of PackageData types including rate features -->
<PackageData>
<PackageID>room_with_addl_benefits</PackageID>
<Name>
<Text text="Acme Hotels 2017 Promotion Package" language="en"/>
</Name>
<ChargeCurrency>hotel</ChargeCurrency>
<BreakfastIncluded>1</BreakfastIncluded>
<MembershipBenefitsIncluded>
<ProgramName>
<Text language="en" text="Marriott Rewards"/>
</ProgramName>
<ProgramLevel>
<Text language="en" text="Platinum"/>
</ProgramLevel>
</MembershipBenefitsIncluded>
<OnPropertyCredit>
<Amount currency="USD">123.45</Amount>
</OnPropertyCredit>
</PackageData>
<PackageData>
<PackageID>room_with_miles</PackageID>
<Name>
<Text text="Room with Bundled Miles" language="en"/>
</Name>
<ChargeCurrency>hotel</ChargeCurrency>
<MilesIncluded>
<NumberOfMiles>1000</NumberOfMiles>
<Provider>
<Text language="en" text="United Airlines"/>
</Provider>
</MilesIncluded>
<AirportTransportationIncluded direction="from"/>
</PackageData>
</PropertyDataSet>
<!-- The actual list of prices -->
<Result>
…
</Result>
</Transaction>
खाना और फ़ोटोज
इस उदाहरण में खाने के लिए कमरे और पैकेज के मेटाडेटा के बारे में बताया गया है, फ़ोटो और चेक-इन और चेक-आउट करने का समय:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Meals Included" language="en"/>
</Name>
<PhotoURL>
<Caption>
<Text text="Breakfast" language="en"/>
<Text text="朝食" language="ja"/>
</Caption>
<URL>http://example.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Meals>
<!-- Guests can choose to have breakfast in their room or in another
space to avoid contact with other guests. -->
<Breakfast included="1" in_room="1" in_private_space="1"/>
<Dinner included="1" buffet="1"/>
</Meals>
<CheckinTime>15:00</CheckinTime>
<CheckoutTime>11:00</CheckoutTime>
</PackageData>
</PropertyDataSet>
</Transaction>
नाश्ता
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
</Name>
<PhotoURL>
<Caption>
<Text text="Breakfast" language="en"/>
<Text text="朝食" language="ja"/>
</Caption>
<URL>http://example.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Meals>
<Breakfast included="true"/>
<!-- Dinner not included needs to be explicitly specified -->
<Dinner included="false"/>
</Meals>
<CheckinTime>15:00</CheckinTime>
<CheckoutTime>11:00</CheckoutTime>
</PackageData>
</PropertyDataSet>
</Transaction>
<Result>
<Transaction>
में कीमत और उपलब्धता के बारे में अपडेट देने वाला कंटेनर
दिखाई देगा.
<Result>
एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है
लेन-देन के मैसेज की एक्सएमएल हैरारकी:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
कमरे का किराया सेट या अपडेट करने और तय करने के लिए <Result>
का इस्तेमाल करें
उपलब्ध इन्वेंट्री में. इस एलिमेंट में तय किए गए आइटम आम तौर पर रेफ़रंस के लिए दिए जाते हैं
किसी कमरे या पैकेज की यात्रा का मेटाडेटा (जैसे, इवेंट का ब्यौरा या
सुविधाओं का सेट) के बारे में <PackageData>
और <RoomData>
में बताया गया है.
आम तौर पर, आपको कीमत के अपडेट के साथ लेन-देन की जानकारी बार-बार भेजी जाती है. यह आपके डिलीवरी मोड पर निर्भर करता है कि आप ऐसा कितनी बार और कब करते हैं.
लेन-देन वाले मैसेज में <Result>
का इस्तेमाल करके, यात्रा की योजनाएं इस तरह से हटाई जा सकती हैं:
इन्वेंट्री हटाना सेक्शन में बताया गया है.
कीमतें अपडेट करने के लिए, लेन-देन से जुड़े मैसेज का इस्तेमाल करने और
खरीदारी के लिए उपलब्धता, इन्वेंट्री जोड़ना और अपडेट करना.
एक लेन-देन मैसेज में कई <Result>
एलिमेंट शामिल हो सकते हैं
उसमें, जब तक कि संदेश का आकार 100MB से अधिक न हो.
सिंटैक्स
<Result>
एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> <!-- Required --> <Property>hotel_ID</Property> <!-- Required --> <Checkin>YYYY-MM-DD</Checkin> <!-- Required --> <Nights>number_of_nights</Nights> <Baserate currency="currency_code">price</Baserate> <!-- Only required when <Baserate> contains a real price --> <Tax currency="currency_code">tax_amount</Tax> <!-- Only required when <Baserate> contains a real price --> <OtherFees currency="currency_code">fee_amount</OtherFees> <Refundable available="[false|true]" refundable_until_days="number_of_days" refundable_until_time="time"/> <RoomID>room_ID</RoomID> <PackageID>package_ID</PackageID> <ExpirationTime>expiration_time</ExpirationTime> <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency> <Occupancy>max_number_of_intended_occupants</Occupancy> <!-- For Baserate, occupancy value must be greater than or equal to 2. If a value is not provided for occupancy, it defaults to 2. --> <OccupancyDetails>occupancy_info</OccupancyDetails> <Rates>...</Rates> <RoomBundle>...</RoomBundle> <AllowablePointsOfSale> <PointOfSale id="landing_page_identifier"/> ... </AllowablePointsOfSale> <Custom[1-5]>custom_value</Custom[1-5]> </Result> ... </Transaction>
विशेषताएं
<Result>
एलिमेंट में ये एट्रिब्यूट मौजूद हैं:
एट्रिब्यूट | ज़रूरी है? | टाइप | ब्यौरा |
---|---|---|---|
mergeable | Optional | boolean | डिफ़ॉल्ट रूप से, किसी होटल और यात्रा की योजना के लिए, नई कीमतें
Google की कैश मेमोरी में मौजूद, पिछली (समयसीमा खत्म नहीं हुई) कीमतों को ओवरराइट कर दें. कॉन्टेंट बनाने
मर्ज किए जा सकने वाले एट्रिब्यूट की मदद से, Google की कैश मेमोरी में अतिरिक्त कीमतें सेव की जा सकती हैं
कीमत से जुड़ी पिछली जानकारी मिटाए बिना. इसके साथ लाइव मूल्य-निर्धारण क्वेरी
कॉन्टेक्स्ट के हिसाब से दिए जाने वाले जवाबों में, इस एट्रिब्यूट को हमेशा true पर सेट किया जाएगा
(आपके लेन-देन वाले मैसेज के जवाब पर ध्यान दिए बिना). |
चाइल्ड एलीमेंट
<Result>
एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:
चाइल्ड एलिमेंट | ज़रूरी है? | टाइप | ब्यौरा |
---|---|---|---|
<AllowablePointsOfSale> | Optional | Object | एक या एक से ज़्यादा ऐसे लैंडिंग पेज हैं जो
होटल. लैंडिंग पेज एक ऐसी वेबसाइट है जो
असली उपयोगकर्ता. किसी खास लैंडिंग पेज को साफ़ तौर पर शामिल करने और
अन्य), एक या ज़्यादा <AllowablePointsOfSale> जोड़ें
<PointOfSale> एलिमेंट से मेल खाने वाले एलिमेंट
लैंडिंग पेजों की फ़ाइल में id एट्रिब्यूट की वैल्यू सबमिट करें.
अगर आप इस एलिमेंट को शामिल नहीं करते हैं, तो लैंडिंग पेज फ़ाइल का इस्तेमाल बुकिंग के लिए किया जा सकता है कमरा. ज़्यादा जानकारी के लिए, इसे देखें लैंडिंग पेजों वाली फ़ाइल सिंटैक्स. |
<Baserate> | Optional | float | ठहरने के लिए कमरे का किराया. इस एलिमेंट की वैल्यू इसमें नीचे दी गई जानकारी शामिल होनी चाहिए:
जब यात्रा की योजना के लिए कमरा उपलब्ध न हो,
रूम बंडल हटाने के लिए, रूम बंडल हटाने में दिए गए निर्देशों का इस्तेमाल करें.
<Baserate currency="USD">1200.40</Baserate>
|
<ChargeCurrency> | Optional | enum | उपयोगकर्ता बुकिंग के लिए कब और कहां पैसे चुकाता है. यह एलिमेंट ये काम कर सकता है:
<Result> में लेन-देन मैसेज में इस्तेमाल किया जाएगा
होटल की कीमत या <PackageData> ब्लॉक के लिए एलिमेंट
एक अलग कमरे बुक करने के लिए.
मान्य मान हैं:
डिफ़ॉल्ट वैल्यू |
<Checkin> | Required | Date | तारीख का इस्तेमाल करके, यात्रा की योजना में चेक इन करने की तारीख
फ़ॉर्मैट. <Nights> एलिमेंट और
<Checkin> एलिमेंट, यात्रा की योजना बनाता है. |
<Custom[1‑5]> | Optional | string | कस्टम फ़ील्ड के बारे में बताता है. इसका इस्तेमाल करके, अतिरिक्त डेटा भेजा जा सकता है
किसी होटल से जुड़ा हुआ है. आपके पास ज़्यादा से ज़्यादा पांच कस्टम वैल्यू पास करने का विकल्प होता है.
ये एलिमेंट के नाम:
<Custom> |
<ExpirationTime> | Optional | DateTime | वह तारीख और समय जब कीमत को खत्म माना जाता है (3 घंटे
कम से कम).
हमारा सुझाव है कि अगर समयसीमा खत्म होने की तारीख है, तो उसे न दें आपके कीमतें तय करने के तरीके के लिए अहम नहीं है. Google ऐसे किराये और यात्रा की योजना नहीं दिखाता जिनकी समयसीमा खत्म हो गई हो जिसकी समयसीमा खत्म हो चुकी है, वह इस ऑफ़र का फ़ायदा ले पाएगा मौजूदा कीमत के बारे में क्वेरी करना. |
<Nights> | Required | integer | किसी यात्रा की योजना के लिए रातों की संख्या. इस कीवर्ड का मान
<Nights> एलिमेंट एक पॉज़िटिव पूर्णांक होना चाहिए.
<Nights> और का कॉम्बिनेशन
<Checkin> एक यात्रा योजना तैयार करता है. |
<OtherFees> | Optional | float | मूल दर और टैक्स के अलावा शुल्क, जो
कमरे की कुल कीमत. <OtherFees> एलिमेंट
currency के लिए एक ऐसा ज़रूरी एट्रिब्यूट है जो
शुल्क के लिए तीन अक्षर वाला मुद्रा कोड. उदाहरण के लिए, USD .
|
<Occupancy> | Optional | integer | इससे पता चलता है कि इस किराये के लिए, ज़्यादा से ज़्यादा कितने लोगों की बुकिंग की जा सकती है.
जब <Occupancy> सीधे <Result> के नीचे दिखता है,
इसमें 2 या इससे ज़्यादा की जानकारी होनी चाहिए. <Occupancy> हो सकते हैं
<OccupancyDetails> के साथ होना चाहिए, जो यह बताता है कि
मेहमानों की संख्या (वयस्क या बच्चे). अगर मेहमान टाइप तय नहीं किया गया है,
उन्हें वयस्क माना जाता है. इसके लिए, <OccupancyDetails> से सलाह लें
चाइल्ड एलिमेंट का सिंटैक्स और जानकारी. अगर
<Occupancy> एलिमेंट नहीं दिया गया है, व्यस्तता की दर
डिफ़ॉल्ट तौर पर 2 पर सेट है.
ध्यान दें: इस सुविधा को चालू करने के लिए, अपनी सहायता टीम से संपर्क करें दो लोग नहीं होने पर की गई बुकिंग के लिए किराये की जानकारी भेज सकते हैं. |
<PackageID> | Optional | string | पहले से तय पैकेज डेटा के साथ मैप करने के लिए पैकेज का यूनीक आईडी. इसका इस्तेमाल PACKAGE-ID के लैंडिंग पेज वैरिएबल में जानकारी भरने के लिए भी किया जाता है. ज़्यादा जानकारी के लिए, इसे देखें रूम बंडल मेटाडेटा. |
<Property> | Required | string | ऐसे होटल का आईडी जिस पर संबंधित डेटा (कीमत,
यात्रा की योजना, रूम बंडल या मेटाडेटा). इस एलिमेंट का मान यह होना चाहिए
स्ट्रिंग. इस एलिमेंट की वैल्यू, स्टोर पेज पर मौजूद वैल्यू से मेल खानी चाहिए
<id> , जिसे आपने अपने होटल सूची फ़ीड में तय किया है.
|
<Rates> | Optional | <Rates> |
एक या उससे ज़्यादा <Rate> ब्लॉक के लिए कंटेनर. हर <Rate> इंच
<Rates> ने कमरे/यात्रा की योजना के लिए अलग कीमत तय की है
संयोजन.
जब के लिए एक से ज़्यादा दरें हों, तो ध्यान दें: |
<Refundable> | Optional | Object | इससे किराये की जानकारी को पूरा रिफ़ंड या मुफ़्त उपलब्ध कराने के तौर पर लिस्ट किया जाता है
रद्द करने की प्रक्रिया. अगर यह जानकारी नहीं दी जाती है, तो रिफ़ंड के बारे में कोई जानकारी नहीं दिखाई जाएगी.
<PackageData> के लेवल पर रिफ़ंड नीति, रिफ़ंड नीति की जगह लागू हो जाती है
<Result> लेवल. <Rates> लेवल पर रिफ़ंड नीति में बदलाव
रिफ़ंड नीति को <PackageData> के लेवल पर सबमिट करें. रिफ़ंड की जा सकने वाली कीमत
उपयोगकर्ताओं के लिए, सीधे तौर पर नहीं दिए गए अन्य विकल्पों की मदद से भी उन्हें हाइलाइट किया जाएगा
ट्रांज़ैक्शन मैसेज के स्कीमा में बदलाव किया जा रहा है. इसके बारे में ज़्यादा जानें
किराये के रिफ़ंड के लिए बनी नीति.
यहां दिए गए उदाहरण में, <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> ध्यान दें: हमारा सुझाव है कि आप सभी एट्रिब्यूट को सेट करें. एक फ़ीड स्थिति के बारे में चेतावनी देने वाला मैसेज तब जनरेट होता है, जब एक या उससे ज़्यादा एट्रिब्यूट सेट नहीं है. अगर आपने कोई एट्रिब्यूट सेट नहीं किया है, तो दर इस तरह नहीं दिखती है रिफ़ंड किया जा सकता है. एट्रिब्यूट:
एट्रिब्यूट सेट करते समय, इन बातों का ध्यान रखें:
|
<RoomBundle> | Optional | <RoomBundle> |
एक कंटेनर, जिसमें कमरे की कीमत के बारे में जानकारी होती है,
सभी सुविधाओं की पैकेजिंग और खरीदारी की नीति के बारे में जानकारी
होटल और यात्रा की योजना.
आम तौर पर, इस एलिमेंट का इस्तेमाल करके बेस रूम का किराया तय करें और एक ही प्रॉपर्टी में अलग-अलग तरह के कमरे. हालांकि, यह मुमकिन है अगर कमरे के बंडल की जानकारी को इनलाइन तरीके से परिभाषित करना है, तो लेन-देन से जुड़ा मैसेज लिखें. Google सेव करेगा मेटाडेटा को दोहराने के बजाय इसका संदर्भ दें आने वाले समय में कीमत से जुड़े अपडेट. |
<RoomID> | Optional | string | रूम का यूनीक आईडी, ताकि उसे पहले से तय किए गए रूम के डेटा से मैप किया जा सके. साथ ही इसका इस्तेमाल PARTNER-ROOM-ID के लैंडिंग पेज वैरिएबल को भरने के लिए किया जाता है. ज़्यादा जानकारी के लिए, इसे देखें रूम बंडल मेटाडेटा. |
<Tax> | Optional | float | इनमें कमरे की कुल कीमत के हिसाब से टैक्स दिए जाते हैं.
<Tax> एलिमेंट में एक ज़रूरी एट्रिब्यूट होता है,
currency , जो तीन अक्षरों वाले मुद्रा कोड की जानकारी देता है
टैक्स के लिए. उदाहरण के लिए, USD . कॉन्टेंट बनाने
<Tax> एलिमेंट ज़रूरी है, अगर
<Baserate> , शून्य से ज़्यादा है.
अगर |
<Unavailable> | Optional | Object | इससे पता चलता है कि यात्रा की योजना, बुकिंग के लिए उपलब्ध नहीं है. के तौर पर काम करता है
. एक
अनुपलब्धता के अन्य कारणों को
<Unavailable> टैग:
|
उदाहरण
एक से ज़्यादा प्रॉपर्टी का उदाहरण
नीचे दिए गए उदाहरण में, एक यात्रा की योजना और दो फ़्लाइट की कीमत के बारे में बताया गया है प्रॉपर्टी:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">278.33</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="site1"/>
</AllowablePointsOfSale>
</Result>
<Result>
<Property>052213</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">299.98</Baserate>
<Tax currency="USD">26.42</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="otto"/>
<PointOfSale id="simon"/>
</AllowablePointsOfSale>
</Result>
</Transaction>
इस उदाहरण में कमरे का ब्यौरा नहीं दिया गया है, जैसे कि ब्यौरा, तस्वीर और कैप्शन, कमरे का नाम, और उसकी कपैसिटी.
उस जानकारी को किसी अलग लेन-देन में एक बार तय किया जा सकता है को सेव करता है, जिसे Google सेव करता है. इसके बाद, आप इसकी कीमतों और इन्वेंट्री को अपडेट किया जाएगा. ज़्यादा जानकारी के लिए, इसे देखें रूम बंडल का मेटाडेटा.
एक से ज़्यादा दर का उदाहरण
इस उदाहरण में, एक यात्रा की योजना और कई प्रॉपर्टी के बारे में बताया गया है
अलग-अलग बुकिंग के लिए मान्य किराया. <Rates>
एलिमेंट का इस्तेमाल इन कामों के लिए किया जा सकता है
किसी खास प्रॉपर्टी के लिए अलग-अलग किराया दिखाने की सुविधा देता है. यह उदाहरण है
छुट्टियों में किराये पर लेने की सुविधा (वीआर) प्रॉपर्टी के लिए भी मददगार:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-07-23T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2021-01-13</Checkin>
<Nights>9</Nights>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>2</Occupancy>
<Rates>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>1</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>3</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>4</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>5</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>6</Occupancy>
</Rate>
</Rates>
</Result>
</Transaction>
अनुपलब्ध उदाहरण
इस उदाहरण में, यात्रा की एक योजना के बारे में बताया गया है, जिसकी उपलब्धता डाउनस्ट्रीम चैनलों से लिया गया. यह संख्या, एक सेकंड की वैल्यू से कम है रात में ठहरना और तय तारीखों के लिए पहले से बुक होना चाहिए. साथ ही, तीसरे पक्ष की प्रॉपर्टी आने की तारीख पर बंद हो जाती है, लेकिन वह ठहरने का समय:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Unavailable>
<NotFetched/>
</Unavailable>
</Result>
<Result>
<Property>073313</Property>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Unavailable>
<NoVacancy/>
<MinNightStay value=3/>
</Unavailable>
</Result>
<Result>
<Property>052213</Property>
<Checkin>2018-06-10</Checkin>
<Nights>10</Nights>
<Unavailable>
<PropertyClosed first_open="2018-06-15" first_closed="2018-06-10"/>
</Unavailable>
</Result>
</Transaction>
<Rates>
एक या उससे ज़्यादा <Rate>
ब्लॉक के लिए कंटेनर. हर <Rate>
इंच
<Rates>
, कमरे या यात्रा की योजना के लिए अलग-अलग किराया तय करता है.
<Rates>
एलिमेंट का इस्तेमाल सिर्फ़ तब करें, जब इसके लिए एक से ज़्यादा दरें उपलब्ध हों
कमरे या यात्रा की योजना एक ही होनी चाहिए. उदाहरण के लिए, आप एकाधिक
खास किराये की दरें,
निजी किराये या
रूम बंडल में खास किराये.
<Rates>
एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है
लेन-देन के मैसेज की एक्सएमएल हैरारकी:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
(Can also contain<Rates>
) + ...
<Rate>
में सेट की गई वैल्यू,
पैरंट <Result>
या <RoomBundle>
एलिमेंट. अगर इन्हें <Rate>
में सेट नहीं किया गया है,
उनकी वैल्यू, पैरंट एलिमेंट से इनहेरिट की जाती है. सिर्फ़
<AllowablePointsofSale> <RoomBundle>
एलिमेंट में इनहेरिट की जाती है.
सिंटैक्स
<Rates>
एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> <Rates> <Rate rate_rule_id="rate_rule_id"> <Baserate currency="currency_code">price</Baserate> <Tax currency="currency_code">tax_amount</Tax> <OtherFees currency="currency_code">fee_amount</OtherFees> <ExpirationTime>expiration_time</ExpirationTime> <Refundable available="[false|true]" refundable_until_days="number_of_days" refundable_until_time="time"/> <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency> <AllowablePointsOfSale> <PointOfSale id="landing_page_identifier"/> </AllowablePointsOfSale> <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <!-- optional info about the types of guests, whether adults or children --></OccupancyDetails> ... <Custom[1-5]>custom_value</Custom[1-5]> </Rate> ... </Rates> </Result> ... </Transaction>
विशेषताएं
<Rates>
एलिमेंट में ये एट्रिब्यूट मौजूद हैं:
एट्रिब्यूट | ज़रूरी है? | ब्यौरा |
---|---|---|
rate_rule_id | Optional | के लिए खास किराये, यह आईडी आपकी परिभाषा से मेल खाता है रेट के नियम की परिभाषा वाली फ़ाइल. इस फ़ील्ड के लिए वर्ण सीमा 40 है वर्ण |
चाइल्ड एलीमेंट
<Rates>
एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:
चाइल्ड एलिमेंट | ज़रूरी है? | टाइप | ब्यौरा |
---|---|---|---|
<AllowablePointsOfSale> | Optional | Object | एक या एक से ज़्यादा ऐसे लैंडिंग पेज हैं जो
होटल. यह एलिमेंट,
<Result> पर <AllowablePointsOfSale> . |
<Baserate> | Required | float | ठहरने के लिए कमरे का किराया. यह एलिमेंट उसी यूआरएल का इस्तेमाल करता है
<Result> पर <Baserate> के रूप में सिंटैक्स.
ध्यान दें: नीचे दिया गया |
<ChargeCurrency> | Optional | enum | उपयोगकर्ता बुकिंग के लिए कब और कहां पैसे चुकाता है. यह एलिमेंट
<ChargeCurrency> जैसा सिंटैक्स
<Result> . |
<Custom[1‑5]> | Optional | string | ऐसे कस्टम फ़ील्ड जिनका इस्तेमाल करके, उपयोगकर्ता से जुड़ा अतिरिक्त डेटा भेजा जा सकता है
होटल को लैंडिंग पेज पर ले जाता है. यह एलिमेंट,
<Result> में <Custom[1‑5]> . इसकी सीमा तय है
हर कस्टम फ़ील्ड में ज़्यादा से ज़्यादा 200 वर्ण. ज़्यादा जानकारी के लिए, इसे देखें
लैंडिंग पेज फ़ाइलें शामिल होती हैं.
अगर <कस्टम> इन एलिमेंट में
|
<ExpirationTime> | Optional | DateTime | वह तारीख और समय जब किराये की अवधि को खत्म माना जाता है. यह
तत्व उसी सिंटैक्स का उपयोग करता है,
<Result> में <ExpirationTime> . |
<Occupancy> | Optional | integer | इससे पता चलता है कि इस किराये के लिए, ज़्यादा से ज़्यादा कितने लोगों की बुकिंग की जा सकती है. अगर नहीं
माना जाता है कि यह मूल दर ही है.
|
<OtherFees> | Required | float | मूल दर और टैक्स के अलावा वे शुल्क जो आखिरी कीमत पर असर डालते हैं
एक कमरे में रखा. यह एलिमेंट, उसी सिंटैक्स का इस्तेमाल करता है जो
<Result> में <OtherFees> .
अगर |
<Refundable> | Optional | Object | इससे किराये की जानकारी को पूरा रिफ़ंड या मुफ़्त उपलब्ध कराने के तौर पर लिस्ट किया जाता है
रद्द करने की प्रक्रिया. अगर यह जानकारी नहीं दी जाती है, तो रिफ़ंड के बारे में कोई जानकारी नहीं दिखाई जाएगी.
<PackageData> लेवल पर रिफ़ंड नीति, रिफ़ंड नीति को बदल देती है
<Result> लेवल पर. <Rates> लेवल पर रिफ़ंड नीति में बदलाव
रिफ़ंड नीति को <PackageData> के लेवल पर सबमिट करें. रिफ़ंड की जा सकने वाली कीमत
उपयोगकर्ताओं के लिए, सीधे तौर पर नहीं दिए गए अन्य विकल्पों की मदद से भी उन्हें हाइलाइट किया जाएगा
ट्रांज़ैक्शन मैसेज के स्कीमा में बदलाव किया जा रहा है. इन विकल्पों के बारे में ज़्यादा जानें
किराये के रिफ़ंड के लिए बनी नीति.
यहां दिए गए उदाहरण में, <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> ध्यान दें: हमारा सुझाव है कि आप सभी एट्रिब्यूट को सेट करें. एक फ़ीड स्थिति के बारे में चेतावनी देने वाला मैसेज तब जनरेट होता है, जब एक या उससे ज़्यादा एट्रिब्यूट सेट नहीं है. अगर आपने कोई एट्रिब्यूट सेट नहीं किया है, तो दर इस तरह नहीं दिखती है रिफ़ंड किया जा सकता है. एट्रिब्यूट:
एट्रिब्यूट सेट करते समय, इन बातों का ध्यान रखें:
|
<Tax> | Required | float | इनमें कमरे की कुल कीमत के हिसाब से टैक्स दिए जाते हैं. यह
एलिमेंट एक ही सिंटैक्स का इस्तेमाल करता है, जैसा कि <Tax>
<Result> . |
उदाहरण
मूल दर और शर्तों के हिसाब से किराया
इस उदाहरण में, लेन-देन का मैसेज दिखाया गया है. इसमें मूल दर की जानकारी दी गई है और एक खास दर:
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">200.00</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<Rates>
<!-- The rate_rule_id is required when using conditional rates -->
<Rate rate_rule_id="mobile">
<!-- Override base rate and taxes for conditional rates -->
<Baserate currency="USD">180.00</Baserate>
<Tax currency="USD">18.00</Tax>
<!-- NOTE: OtherFees is inherited from the above setting -->
<Custom1>ratecode123</Custom1>
</Rate>
</Rates>
</Result>
</Transaction>
एक से ज़्यादा खास किराया
इस उदाहरण में मूल दर और एक से ज़्यादा खास किराये के बारे में बताया गया है
<RoomBundle>
में:
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>2</Nights>
<!-- When Google receives new room bundle information for an itinerary, all
previous room bundle pricing is dropped from Google's cache. Thus, if you
want to delete a specific room bundle from Google's cache, you may do so
by simply not providing that specific room bundle in subsequent transaction
messages. -->
<RoomBundle>
...
<!-- RoomID is required, PackageID is recommended. -->
<RoomID>5</RoomID>
<PackageID>ABC</PackageID>
<!-- Baserate is required. -->
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<!-- RatePlanID is optional and represents the unique identifier for a
room and package data combination. We strongly recommend using RatePlanID
as a variable to build your dynamic landing page (formerly Point of Sale)
URL. For details, see Using Variables and Conditions. -->
<RatePlanID>5-ABC</RatePlanID>
<!-- Occupancy is mandatory for RoomBundle elements. -->
<!-- Elements below will get inherited to nested rate elements. -->
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
</OccupancyDetails>
<InternetIncluded>1</InternetIncluded>
<!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
<ChargeCurrency>web</ChargeCurrency>
<Custom1>ratebasic</Custom1>
<!-- Neither rate overrides Custom2. -->
<Custom2>ratebasic</Custom2>
<Rates>
<Rate rate_rule_id="mobile">
<Baserate currency="USD">258.33</Baserate>
<Tax currency="USD">25.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides ChargeCurrency from roombundle. -->
<ChargeCurrency>hotel</ChargeCurrency>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode321</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
<Rate rate_rule_id="us_or_gb">
<Baserate currency="USD">268.33</Baserate>
<Tax currency="USD">26.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode432</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>
<RoomBundle>
इससे यह तय होता है कि रूम बंडल किस कीमत पर और उनके लिए उपलब्ध है या नहीं
<Result>
को <Transaction>
मैसेज में. हर एक के लिए एक अलग एलिमेंट तय करें
पैकेज या यात्रा योजना का मिला-जुला रूप. पैकेज और शर्तों को परिभाषित करने के लिए
रूम बंडल, <RoomData>
इस्तेमाल करें.
<RoomBundle>
एलिमेंट, इसमें नीचे दी गई जगह पर दिखता है
लेन-देन के मैसेज की एक्सएमएल हैरारकी:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
ज़्यादा जानकारी के लिए, रूम बंडल का इस्तेमाल करना देखें.
सिंटैक्स
<RoomBundle>
एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> ... <RoomBundle> <!-- Required unless specified inline under<RoomData>
--> <RoomID>room_ID</RoomID> <!-- Required<PackageData>
--> <PackageID>package_ID</PackageID> <!-- Required --> <Baserate currency="currency_code">price</Baserate> <!-- Required --> <Tax currency="currency_code">taxes</Tax> <!-- Required --> <OtherFees currency="currency_code">other_fees</OtherFees> <Refundable available="[false|true]" refundable_until_days="number_of_days" refundable_until_time="time"/> <!-- Required --> <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency> <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <!-- optional info about the types of guests, whether adults or children --></OccupancyDetails> <BreakfastIncluded>boolean_value</BreakfastIncluded> <InternetIncluded>boolean_value</InternetIncluded> <ParkingIncluded>boolean_value</ParkingIncluded> <RatePlanID>rate_plan_ID</RatePlanID> <Rates>...</Rates> <Custom1>custom_value_1</Custom1> <Custom2>custom_value_2</Custom2> <Custom3>custom_value_3</Custom3> <Custom4>custom_value_4</Custom4> <Custom5>custom_value_5</Custom5> </RoomBundle> ... </Result> </Transaction>
विशेषताएं
<RoomBundle>
एलिमेंट में कोई एट्रिब्यूट नहीं है.
चाइल्ड एलीमेंट
<RoomBundle>
एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:
चाइल्ड एलिमेंट | ज़रूरी है? | टाइप | ब्यौरा |
---|---|---|---|
<Baserate> | Required | float | इससे, ठहरने के लिए कमरे के बंडल का किराया तय होता है. यह एलिमेंट,
वही सिंटैक्स जो <Result> में <Baserate> में है, जिसमें
अपवाद:
|
<BreakfastIncluded> | Optional | boolean | इससे पता चलता है कि इस रूम बंडल में, किराये पर मिलने वाला नाश्ता शामिल है या नहीं. |
<ChargeCurrency> | Optional | enum | उपयोगकर्ता बुकिंग के लिए कब और कहां पैसे चुकाता है. यह एलिमेंट उसी यूआरएल का इस्तेमाल करता है
<Result> में <ChargeCurrency> के रूप में सिंटैक्स.
डिफ़ॉल्ट वैल्यू |
<Custom[1‑5]> | Optional | string | लैंडिंग पेजों को अतिरिक्त डेटा भेजने के लिए कस्टम फ़ील्ड
कमरे के बंडल के लिए. ये एलिमेंट, एक ही सिंटैक्स का इस्तेमाल करते हैं
<Result> में <Custom[1-5]> . इसकी सीमा 200 है
वर्ण प्रति कस्टम फ़ील्ड. ज़्यादा जानकारी के लिए, इसे देखें
लैंडिंग पेज फ़ाइलों में भी ये फ़ाइलें शामिल होती हैं.
अगर <कस्टम> इन एलिमेंट में
|
<InternetIncluded> | Optional | boolean | अगर किसी रूम बंडल में बिना किसी शुल्क के इंटरनेट की सुविधा शामिल है, जबकि अन्य बंडल में यह सुविधा उपलब्ध नहीं होगी. इसे सेट न करें होटल के उस होटल के रूम बंडल में इस्तेमाल होने वाले एलिमेंट जो मुफ़्त इंटरनेट की सुविधा देते हैं कमरे. यह एलिमेंट, कमरे में वायर वाले इंटरनेट या वायरलेस इंटरनेट कनेक्शन पर लागू नहीं होता जो कमरों में उपलब्ध नहीं है. |
<Occupancy> | Required | integer | इससे पता चलता है कि इस किराये के लिए, ज़्यादा से ज़्यादा कितने लोगों की बुकिंग की जा सकती है. उदाहरण के लिए,
बड़े सुइट में छह मेहमानों के बैठने की सुविधा हो सकती है. हालांकि,
"हनीमून पैकेज" सिर्फ़ दो मेहमानों के इस्तेमाल की अनुमति है.
यह मान इससे कम या इसके बराबर होना चाहिए:
अपने लैंडिंग पेज यूआरएल में व्यस्तता की जानकारी देते समय,
ध्यान दें:
|
<OtherFees> | Required | float | मूल दर और टैक्स के अलावा शुल्क, जो
कमरे की कुल कीमत. <OtherFees> एलिमेंट
currency के लिए एक ऐसा ज़रूरी एट्रिब्यूट है जो
शुल्क के लिए तीन अक्षर वाला मुद्रा कोड. उदाहरण के लिए,
डॉलर में USD चुकाएं. |
<PackageID> | Optional (recommended) | string | पैकेज डेटा के लिए यूनीक आईडी. इस आईडी का इस्तेमाल
<PackageData> में भेजी गई जानकारी के साथ कमरे का बंडल डेटा. इसके लिए
ज़्यादा जानकारी के लिए,
रूम
बंडल मेटाडेटा. (आप
इस आईडी का इस्तेमाल, इस्तेमाल किए गए रूम बंडल की परिभाषा का रेफ़रंस देने के लिए भी किया जा सकता है
रूम बंडल डेटा तय करते समय एक ही लेन-देन मैसेज में
inline.) |
<ParkingIncluded> | Optional | boolean | रूम बंडल में बिना किसी शुल्क के पार्किंग शामिल है या नहीं,
अगर ऐसा नहीं है, तो इस होटल में पार्किंग की सुविधा के लिए पैसे चुकाने होंगे. जानकारी न दें
मुफ़्त पार्किंग की सुविधा देने वाले होटल के लिए इस एलिमेंट का मान.
मान्य वैल्यू |
<RatePlanID> | Optional | string | किराये के प्लान का आईडी,
कमरा और पैकेज का कॉम्बिनेशन. उदाहरण के लिए, दिए गए
5 और एक का <RoomID> मान
ABC का <PackageID> मान, आप
<RatePlanID> के लिए 5-ABC. हमारा सुझाव है कि आप
अपना डाइनैमिक लैंडिंग पेज बनाने के लिए, RatePlanID का वैरिएबल के रूप में रेट
(पहले पॉइंट ऑफ़ सेल था) यूआरएल.
ज़्यादा जानकारी के लिए, इसे देखें वैरिएबल का इस्तेमाल करना और शर्तें. |
<Rates> | Optional | <Rates> |
किराये जो इस रूम बंडल के लिए डिफ़ॉल्ट सेटिंग को बदल देते हैं. यह
एलिमेंट, <Result> में <Rates> के समान सिंटैक्स का इस्तेमाल करता है. |
<Refundable> | Optional | Object | इससे किराये की जानकारी को पूरा रिफ़ंड या मुफ़्त उपलब्ध कराने के तौर पर लिस्ट किया जाता है
रद्द करने की प्रक्रिया. अगर यह जानकारी नहीं दी जाती है, तो रिफ़ंड के बारे में कोई जानकारी नहीं दिखाई जाएगी.
<PackageData> के लेवल पर रिफ़ंड नीति, रिफ़ंड नीति की जगह लागू हो जाती है
<Result> लेवल. <Rates> लेवल पर रिफ़ंड नीति में बदलाव
रिफ़ंड नीति को <PackageData> के लेवल पर सबमिट करें. रिफ़ंड की जा सकने वाली कीमत
उपयोगकर्ताओं के लिए, सीधे तौर पर नहीं दिए गए अन्य विकल्पों की मदद से भी उन्हें हाइलाइट किया जाएगा
ट्रांज़ैक्शन मैसेज के स्कीमा में बदलाव किया जा रहा है. इन विकल्पों के बारे में ज़्यादा जानें
किराये के रिफ़ंड के लिए बनी नीति.
यहां दिए गए उदाहरण में, <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> ध्यान दें: हमारा सुझाव है कि आप सभी एट्रिब्यूट को सेट करें. एक फ़ीड स्थिति के बारे में चेतावनी देने वाला मैसेज तब जनरेट होता है, जब एक या उससे ज़्यादा एट्रिब्यूट सेट नहीं है. अगर आपने कोई एट्रिब्यूट सेट नहीं किया है, तो दर इस तरह नहीं दिखती है रिफ़ंड किया जा सकता है. एट्रिब्यूट:
एट्रिब्यूट सेट करते समय, इन बातों का ध्यान रखें:
|
<RoomID> | Required | string | रूम के डेटा का यूनीक आईडी. इस आईडी का इस्तेमाल
आपने <RoomData> में जो आइटम भेजा है उसके साथ कमरे का बंडल डेटा.
ज़्यादा जानकारी के लिए, इसे देखें
कमरे के बंडल का मेटाडेटा. (आप इस आईडी का इस्तेमाल
रूम की परिभाषा, एक ही लेन-देन के मैसेज में देते समय बताएं
कमरे के डेटा को इनलाइन देखें.) |
<Tax> | Required | float | इनमें कमरे की कुल कीमत के हिसाब से टैक्स दिए जाते हैं.
<Tax> एलिमेंट में एक ज़रूरी एट्रिब्यूट होता है,
currency , जो तीन अक्षरों वाले मुद्रा कोड की जानकारी देता है
टैक्स के लिए. जैसे, डॉलर के लिए USD का इस्तेमाल करें. |
उदाहरण
एक व्यक्ति के लिए अलग-अलग किराया
इस उदाहरण में, एक ऐसे रिस्पॉन्स के बारे में बताया गया है जिसमें बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या का एक बंडल है.
जब कोई उपयोगकर्ता व्यस्तता चुनने वाले टूल में 1
को चुनता है, तो Google सबसे कम वैल्यू दिखाता है
बुकिंग के लिए तय किया गया किराया, भले ही बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या कितनी भी हो.
अगर एक ही बुकिंग के लिए तय किया गया किराया उपलब्ध नहीं है, तो Google दो लोगों के लिए सबसे कम किराया. ध्यान दें कि एक व्यक्ति के लिए किराये पर लिया गया किराया, लाइव क्वेरी, अगर दो बार बुकिंग या इससे ज़्यादा किराया दिखाने के लिए कैश मेमोरी में सेव किया जाता है यात्रा की योजना.
इस उदाहरण में पहले से तय किए गए कमरे और पैकेज का मेटाडेटा
<RoomID>
और <PackageID>
एलिमेंट. <RoomData>
का इस्तेमाल करें और
<PackageData>
एलिमेंट का इस्तेमाल करें.
<!-- Efficient method of defining Room Bundles-->
<!----- Occupancy of 1 example ----->
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="12345678">
<!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
<!-- Note: Once defined it does not have to be repeated for future
Transaction Messages.
PropertyDataSets can also be defined and sent in their own
Transaction Message separately from pricing. Google can be
configured to pull just PropertyDataSets once per day
(or on a predefined frequency). -->
<PropertyDataSet>
<Property>180054</Property>
<!-- Can be reused by multiple Room Bundles -->
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Queen Room - Non-Smoking" language="en"/>
<Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<!-- Room can accommodate up to 4, but package data specifies occupancy
between 1 to 4 -->
<Capacity>4</Capacity>
</RoomData>
<RoomData>
<RoomID>436233</RoomID>
<Name>
<Text text="Premium King Room - Non-Smoking" language="en"/>
<Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<Capacity>4</Capacity>
</RoomData>
<!-- Can be reused by multiple Room Bundles -->
<PackageData>
<PackageID>P11111</PackageID>
<Occupancy>1</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
<PackageData>
<PackageID>P54321</PackageID>
<Occupancy>2</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
<PackageData>
<PackageID>P12345</PackageID>
<Occupancy>4</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="1"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
</PropertyDataSet>
<!-- Efficient method of defining Room Bundles -->
<!-- Part 2: Reference RoomData and PackageData through ID -->
<Result>
<!-- Single occupancy pricing will be specified in a room bundle below -->
<Property>180054</Property>
<Checkin>2017-10-07</Checkin>
<Nights>2</Nights>
<!-- Base Room Bundle -->
<RoomBundle>
<RoomID>060773</RoomID>
<PackageID>P54321</PackageID>
<Baserate currency="USD">199.99</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RatePlanID>060773-P54321</RatePlanID>
</RoomBundle>
<RoomBundle>
<RoomID>060773</RoomID>
<PackageID>P11111</PackageID>
<!-- Price for 1 ("occupancy") is the lowest price and will be
displayed -->
<Baserate currency="USD">174.99</Baserate>
<Tax currency="USD">22.08</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RatePlanID>060773-P11111</RatePlanID>
</RoomBundle>
<!-- Premium Room Bundle -->
<RoomBundle>
<RoomID>436233</RoomID>
<PackageID>P12345</PackageID>
<!-- Price for 4 ("occupancy"), any eligible room bundle with 1 or more
occupancy will be displayed-->
<Baserate currency="USD">298.88</Baserate>
<Tax currency="USD">42.12</Tax>
<OtherFees currency="USD">10.00</OtherFees>
<RatePlanID>436233-P12345</RatePlanID>
</RoomBundle>
<!-- ..Continue providing all available RoomBundle rates under matched
property for 1 or more occupancies..-->
</Result>
</Transaction>
दो या उससे ज़्यादा बुकिंग
इस उदाहरण में ऐसे जवाब के बारे में बताया गया है जिसमें दो या उससे ज़्यादा ऑक्यूपेंसी शामिल हैं.
इस उदाहरण में पहले से तय किए गए कमरे और पैकेज का मेटाडेटा
<RoomID>
और <PackageID>
एलिमेंट. <RoomData>
का इस्तेमाल करें और
<PackageData>
एलिमेंट का इस्तेमाल करें.
<!-- Efficient method of defining Room Bundles-->
<!----- Occupancy of 3 example ----->
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="12345678">
<!-- Efficient method of defining Room Bundles-->
<!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
<PropertyDataSet>
<Property>180054</Property>
<!-- Can be reused by multiple Room Bundles -->
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Queen Room - Non-Smoking" language="en"/>
<Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<!-- Room can accommodate up to 4, but package data specifies occupancy
between 1 to 4 -->
<Capacity>4</Capacity>
</RoomData>
<RoomData>
<RoomID>436233</RoomID>
<Name>
<Text text="Premium King Room - Non-Smoking" language="en"/>
<Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<Capacity>4</Capacity>
</RoomData>
<!-- Can be reused by multiple Room Bundles -->
<PackageData>
<PackageID>P33333</PackageID>
<Occupancy>3</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
<PackageData>
<PackageID>P12345</PackageID>
<Occupancy>4</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="1"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
</PropertyDataSet>
<Result>
<Property>180054</Property>
<Checkin>2017-10-07</Checkin>
<Nights>2</Nights>
<!-- Efficient method of defining Room Bundles -->
<!-- Part 2: Reference RoomData and PackageData through ID -->
<!-- Base Room Bundle -->
<RoomBundle>
<!-- Baserate above and attributes must match atleast one room bundle
below -->
<RoomID>060773</RoomID>
<PackageID>P33333</PackageID>
<Baserate currency="USD">499.99</Baserate>
<Tax currency="USD">55.12</Tax>
<OtherFees currency="USD">22.00</OtherFees>
</RoomBundle>
<!-- Premium Room Bundle -->
<RoomBundle>
<RoomID>436233</RoomID>
<PackageID>P12345</PackageID>
<!-- Lowest price for 3 ("occupancy"), shown below, will be displayed -->
<Baserate currency="USD">598.88</Baserate>
<Tax currency="USD">62.12</Tax>
<OtherFees currency="USD">30.00</OtherFees>
</RoomBundle>
<!-- ..Continue providing all available RoomBundle rates under matched
property for 2 or more occupancies..-->
</Result>
</Transaction>
कई कमरों के बंडल
इस उदाहरण में, एक से ज़्यादा रूम बंडल में बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या दिखाने के लिए सेट किया गया है, ताकि यह दिखाया जा सके हॉस्टल के कमरे का संभावित शुल्क.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
<Result>
...
<!-- Suite Room Bundle -->
<RoomBundle>
<RoomID>suite1</RoomID>
<PackageID>standard</PackageID>
<Occupancy>2</Occupancy>
<!-- Price for room -->
<Baserate currency="USD">80.00</Baserate>
<Tax currency="USD">5.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RoomData>
<Name>
<Text text="Suite for 2" language="en"/>
</Name>
</RoomData>
</RoomBundle>
<!-- Small Dorm Room Bundle -->
<RoomBundle>
<RoomID>small_dorm</RoomID>
<PackageID>economy</PackageID>
<Occupancy>1</Occupancy>
<!-- Price per bed -->
<Baserate currency="USD">35.00</Baserate>
<Tax currency="USD">3.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RoomData>
<Name>
<Text text="1 bed in small dorm" language="en"/>
</Name>
</RoomData>
</RoomBundle>
<!-- Large Dorm Room Bundle -->
<RoomBundle>
<RoomID>large_dorm</RoomID>
<PackageID>economy</PackageID>
<Occupancy>1</Occupancy>
<!-- Price per bed -->
<Baserate currency="USD">20.00</Baserate>
<Tax currency="USD">2.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RoomData>
<Name>
<Text text="1 bed in large dorm" language="en"/>
</Name>
</RoomData>
</RoomBundle>
...
</Result>
</Transaction>
अलग-अलग शर्तों के हिसाब से किराया
इस उदाहरण में मूल दर और एक से ज़्यादा खास किराये के बारे में बताया गया है
<RoomBundle>
में:
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>2</Nights>
<!-- When Google receives new room bundle information for an itinerary, all
previous room bundle pricing is dropped from Google's cache. Thus, if you
want to delete a specific room bundle from Google's cache, you may do so
by simply not providing that specific room bundle in subsequent transaction
messages. -->
<RoomBundle>
...
<!-- RoomID is required, PackageID is recommended. -->
<RoomID>5</RoomID>
<PackageID>ABC</PackageID>
<!-- Baserate is required. -->
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<!-- RatePlanID is optional and represents the unique identifier for a
room and package data combination. We strongly recommend using RatePlanID
as a variable to build your dynamic landing page (formerly Point of Sale)
URL. For details, see Using Variables and Conditions. -->
<RatePlanID>5-ABC</RatePlanID>
<!-- Occupancy is mandatory for RoomBundle elements. -->
<!-- Elements below will get inherited to nested rate elements. -->
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
</OccupancyDetails>
<InternetIncluded>1</InternetIncluded>
<!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
<ChargeCurrency>web</ChargeCurrency>
<Custom1>ratebasic</Custom1>
<!-- Neither rate overrides Custom2. -->
<Custom2>ratebasic</Custom2>
<Rates>
<Rate rate_rule_id="mobile">
<Baserate currency="USD">258.33</Baserate>
<Tax currency="USD">25.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides ChargeCurrency from roombundle. -->
<ChargeCurrency>hotel</ChargeCurrency>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode321</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
<Rate rate_rule_id="us_or_gb">
<Baserate currency="USD">268.33</Baserate>
<Tax currency="USD">26.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode432</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>
<OccupancyDetails>
लेन-देन मैसेज में <Occupancy>
से मेहमानों की ज़्यादा से ज़्यादा संख्या के बारे में पता चलता है
एक कमरे या पैकेज के लिए. <OccupancyDetails>
में और जानकारी हो सकती है
जैसे, मेहमानों (वयस्क या बच्चे) की संख्या और उनके टाइप.
जब <Occupancy>
और <OccupancyDetails>
, <Rates>
एलिमेंट में दिखते हैं
<Result>
या <RoomBundle>
का है, तो इसका मतलब है कि दर
बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या की जानकारी.
सिंटैक्स
जब <OccupancyDetails>
दिखता है, तो उसके पहले हमेशा <Occupancy>
होता है.
इस सिंटैक्स का ध्यान रखें:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> ... <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <NumAdults>number_of_adults</NumAdults> <Children> <Child age=age_of_one_child_guest/> <Child age=age_of_one_child_guest/> </Children> </OccupancyDetails> </Result> </Transaction>
चाइल्ड एलीमेंट
<OccupancyDetails>
एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:
चाइल्ड एलिमेंट | ज़रूरी है? | टाइप | ब्यौरा |
---|---|---|---|
<NumAdults> | Required | integer | वयस्क मेहमानों की संख्या. कम से कम:1, ज़्यादा से ज़्यादा:20. |
<Children> | Optional | Object | एक या ज़्यादा <Child> एलिमेंट के लिए कंटेनर. |
<Child age> | Optional | integer | इस बच्चे के लिए ज़्यादा से ज़्यादा उम्र की सीमा—उदाहरण के लिए, <Child age="17"> . |
उदाहरण
ये उदाहरण दिखाते हैं कि <OccupancyDetails>
<Results>
, <RoomBundle>
या <Rates>
चाइल्ड एलिमेंट.
नतीजे पर दिया गया जवाब
नीचे दिए गए उदाहरण में, एक यात्रा की योजना और एक यात्रा की योजना की कीमत के बारे में बताया गया है
लाइव कीमत तय करने से जुड़ी क्वेरी के जवाब में दिखाई जाने वाली प्रॉपर्टी, जहां उपयोगकर्ता ने
मेहमानों की संख्या और उनके प्रकार. यहां, <OccupancyDetails>
-- 2 वयस्क और
एक चाइल्ड -- <Result>
में लौटाया जाता है.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">278.33</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="site1"/>
</AllowablePointsOfSale>
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
</Result>
</Transaction>
किराये का जवाब
नीचे दिए गए उदाहरण में, एक यात्रा की योजना और एक वयस्क के लिए उसकी कीमत के बारे में बताया गया है
और 1 बच्चा. यहां, <OccupancyDetails>
को <Rates>
में दिखाया जाता है
<Result>
का एलिमेंट.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Transaction id="Wtdj8QoQIWcAAbaTGlIAAAC4" timestamp="2018-04-18T11:27:45-04:00">
<Result>
<Property>8251</Property>
<Checkin>2018-06-20</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">62.18</Baserate>
<Tax currency="USD">2.45</Tax>
<OtherFees currency="USD">0.00</OtherFees>
<Rates>
<Rate rate_rule_id="rule-951">
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>1</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
<Baserate currency="USD">42.61</Baserate>
<Tax currency="USD">5.70</Tax>
<OtherFees currency="USD">0.00</OtherFees>
<Custom1>abc4</Custom1>
<AllowablePointsOfSale>
<PointOfSale id="yourhotelpartnersite.com"/>
</AllowablePointsOfSale>
</Rate>
</Rates>
</Result>
</Transaction>
रूम बंडल
नीचे दिए गए उदाहरण में, दो वयस्कों और एक बच्चे के लिए बुकिंग के हिसाब से वयस्कों और बच्चों की संख्या के बारे में बताया गया है
दो रातों के लिए कमरा बुक करें. इसके लिए, कमरे का किराया रिफ़ंड किया जा सकता है. यहां, <OccupancyDetails>
दिखता है
<RoomBundle>
में
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>6781291</Property>
<Checkin>2017-08-05</Checkin>
<Nights>2</Nights>
...
<RoomBundle>
<RoomID>10291</RoomID>
<RatePlanID>564739</RatePlanID>
<PackageID>564739</PackageID>
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="true" refundable_until_days="1" refundable_until_time="23:59:00" />
<Baserate currency="USD">185.34</Baserate>
<Tax currency="USD">37.06</Tax>
<OtherFees currency="USD">2.22</OtherFees>
</RoomBundle>
</Result>
</Transaction>
कई कमरों के बंडल
इस उदाहरण में, <RoomBundle>
के ऐसे कई किराये के बारे में बताया गया है जिन्हें
दो वयस्कों और दो बच्चों के लिए, बुकिंग करने पर पाबंदी है. यहां,
<OccupancyDetails>
, <RoomBundle>
के <Rates>
एलिमेंट में दिखता है.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">0</OtherFees>
<RoomBundle>
<RoomID>5</RoomID>
<PackageID>STD</PackageID>
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">0</OtherFees>
<InternetIncluded>1</InternetIncluded>
<ChargeCurrency>web</ChargeCurrency>
<Custom1>ratebasic</Custom1>
<Custom2>ratebasic</Custom2>
<Occupancy>4</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="17"/>
<Child age="17"/>
</Children>
</OccupancyDetails>
<Rates>
<Rate rate_rule_id="mobile">
<Baserate currency="USD">258.33</Baserate>
<Tax currency="USD">25.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<ChargeCurrency>hotel</ChargeCurrency>
<Custom1>ratecode321</Custom1>
</Rate>
<Rate rate_rule_id="us_or_gb">
<Baserate currency="USD">268.33</Baserate>
<Tax currency="USD">26.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<Custom1>ratecode432</Custom1>
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>