এই পৃষ্ঠাটি XML-ভিত্তিক লেনদেন বার্তাগুলির জন্য একটি রেফারেন্স প্রদান করে৷
<Transaction>
একটি লেনদেন বার্তার মূল উপাদান হল <Transaction> । এটি রুম এবং প্যাকেজ এবং রুম এবং প্যাকেজের জন্য মূল্য এবং প্রাপ্যতা সম্পর্কে বর্ণনামূলক তথ্যের জন্য একটি ধারক।
লেনদেন বার্তা XML অনুক্রমের নিম্নলিখিত স্থানে <Transaction> উপাদানটি উপস্থিত হয়:
+<Transaction>+<PropertyDataSet>// Room and package metadata + <Property> +<RoomData>+<PackageData>+<Result>// Pricing and availability +<Rates>+<RoomBundle>+ ...
যে বার্তাগুলি <Transaction> রুট এলিমেন্ট ব্যবহার করে সেগুলির জন্য অন্তত একটি চাইল্ড এলিমেন্ট প্রয়োজন। লেনদেন বার্তাগুলিতে যেকোন সংখ্যক চাইল্ড উপাদান থাকতে পারে, যতক্ষণ না মোট বার্তার আকার 100 MB-এর বেশি না হয়৷
সিনট্যাক্স
<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 | লেনদেন বার্তা যে অংশীদার অ্যাকাউন্টের জন্য। আপনি সাধারণত এটি ব্যবহার করেন যদি আপনার ব্যাকএন্ড একাধিক অংশীদার অ্যাকাউন্টের জন্য মূল্য ফিড প্রদান করে। এই স্ট্রিং মান হল হোটেল সেন্টারের অ্যাকাউন্ট সেটিংস পৃষ্ঠায় তালিকাভুক্ত "অংশীদার কী" মান। |
| 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>
<MilesIncluded>
<NumberOfMiles>1200</NumberOfMiles>
<Provider>
<Text language="en" text="United Airlines"/>
</Provider>
<LoyaltyCampaignID>my_campaign</LoyaltyCampaignID>
</MilesIncluded>
</Result>
</Transaction>
রাতের হার
নিম্নলিখিত উদাহরণটি 7 জুন, 2023 থেকে শুরু হওয়া 1 থেকে 7 রাতের জন্য মূল্যের ডেটা সংজ্ঞায়িত করে:
<?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>
</Rate>
</Rates>
</Result>
</Transaction>
ইনভেন্টরি সরান
নিম্নলিখিত উদাহরণটি ইনভেন্টরি থেকে একটি হোটেলের জন্য বেশ কয়েকটি ইনভেন্টরি (বিভিন্ন তারিখের জন্য 1-রাত্রি থাকার) সরিয়ে দেয়:
<?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> উপাদানটি লেনদেন বার্তা XML অনুক্রমের নিম্নলিখিত স্থানে উপস্থিত হয়:
+<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> উপাদানটি লেনদেন বার্তা XML অনুক্রমের নিম্নলিখিত স্থানে উপস্থিত হয়:
+<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 জন অতিথিকে (ক্ষমতা = 6) মিটমাট করতে সক্ষম হতে পারে, তবে এটি শুধুমাত্র 4 জন অতিথির জন্য তৈরি। এই মানটি অবশ্যই |
| <OccupancySettings> | Optional | Object | সেটিংস যা একটি রুমের দখলের প্রয়োজনীয়তা সীমাবদ্ধ বা পরিবর্তন করতে পারে।
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> সমস্ত শিশু উপাদান অন্তর্ভুক্ত করার প্রয়োজন নেই। |
| <PhotoURL> | Optional | Object | প্রদত্ত রুম বা রুম বান্ডেলের একটি ছবির জন্য একটি URL এবং ঐচ্ছিক ক্যাপশন৷ আপনি একটি রুম বা রুম বান্ডেলের জন্য একাধিক <PhotoURL> নির্দিষ্ট করতে পারেন। প্রতিটি ছবির URL এর নিজস্ব <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>
রুমে পাওয়া বৈশিষ্ট্য সংজ্ঞায়িত করে।
লেনদেন বার্তা XML অনুক্রমের নিচের জায়গায় <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>
দুটি ডাবল বেড
নিচে দুটি double বেড সহ 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>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>
বিছানা সঙ্গে জাপানি পশ্চিমী
নীচে একটি japanese_western শৈলীর কক্ষের উদাহরণ রয়েছে যেখানে king আকারের বিছানা রয়েছে।
<?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> উপাদানটি লেনদেন বার্তা XML অনুক্রমের নিম্নলিখিত স্থানে উপস্থিত হয়:
+<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>integer</NumberOfMiles>
<Provider>
<Text language="en" text="provider-name">
</Provider>
<!-- Add Loyalty point information -->
<LoyaltyCampaignID>campaign_ID</LoyaltyCampaignID>
</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 | একটি রুম বান্ডেলের জন্য নির্ধারিত সর্বাধিক সংখ্যক অতিথি। উদাহরণস্বরূপ, একটি বড় স্যুট শারীরিকভাবে 6 জন অতিথিকে মিটমাট করতে সক্ষম হতে পারে, তবে এটি শুধুমাত্র 4 জন অতিথির জন্য তৈরি। এই মানটি অবশ্যই আপনি যদি এই উপাদানটি দ্রষ্টব্য : <Occupancy> এর সাথে <OccupancyDetails> থাকতে পারে, যা অতিথিদের ধরন (প্রাপ্তবয়স্ক বা শিশু) নির্দিষ্ট করে। সিনট্যাক্স এবং চাইল্ড এলিমেন্টের বর্ণনার জন্য <OccupancyDetails> পড়ুন। |
| <PackageID> | Required | string | প্যাকেজের জন্য অনন্য আইডি। রুম বান্ডেল ডেটার সাথে আপনার মূল্যের আপডেটে থাকা (রুম বান্ডেল ডেটা ইনলাইনে সংজ্ঞায়িত করার সময় একটি একক লেনদেন বার্তায় ব্যবহৃত একটি সাধারণ রুম বান্ডেল সংজ্ঞা উল্লেখ করতে আপনি এই আইডিটি ব্যবহার করতে পারেন।) |
| <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 Included> | Optional | boolean | রেটে থাকার সময়কালের জন্য অভিজাত অবস্থার সুবিধা অন্তর্ভুক্ত। নিম্নলিখিত পরামিতি অন্তর্ভুক্ত:
|
| <CarRentalIncluded> | Optional | boolean | ভাড়া থাকার সময়কালের জন্য বিনামূল্যে গাড়ি ভাড়া অন্তর্ভুক্ত। |
| <MilesIncluded> | Optional | boolean | রেট ফ্রিকোয়েন্ট ফ্লায়ার মাইলস অন্তর্ভুক্ত। পরামিতি অন্তর্ভুক্ত:
দ্রষ্টব্য: |
| <OnPropertyCredit> | Optional | boolean | হারের মধ্যে সম্পত্তির ক্রেডিট (F&B, রিসোর্ট, স্পা, ইত্যাদি) অন্তর্ভুক্ত রয়েছে। পরামিতি:
|
| <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>
<LoyaltyCampaignID>my_campaign</LoyaltyCampaignID>
</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> বার্তায় মূল্য এবং প্রাপ্যতা আপডেটের জন্য একটি ধারক।
লেনদেন বার্তা XML অনুক্রমের নিম্নলিখিত স্থানে <Result> উপাদানটি উপস্থিত হয়:
+<Transaction>+<PropertyDataSet>// Room and package metadata + <Property> +<RoomData>+<PackageData>+<Result>// Pricing and availability +<Rates>+<RoomBundle>+ ...
রুমের দাম সেট বা আপডেট করতে এবং উপলব্ধ ইনভেন্টরি নির্ধারণ করতে <Result> ব্যবহার করুন। এই উপাদানটিতে সংজ্ঞায়িত আইটেমগুলি সাধারণত <PackageData> এবং <RoomData> -এ সংজ্ঞায়িত একটি রুম বা প্যাকেজ (যেমন একটি বিবরণ বা সুবিধার সেট) সম্পর্কে ভ্রমণের-স্বাধীন মেটাডেটা উল্লেখ করে।
আপনি সাধারণত খুব ঘন ঘন মূল্য আপডেট সহ লেনদেন বার্তা পাঠান। ঠিক কিভাবে এবং কত ঘন ঘন আপনি এটি করবেন তা আপনার ডেলিভারি মোডের উপর নির্ভর করে।
আপনি ট্রানজ্যাকশন বার্তায় <Result> ব্যবহার করতে পারেন ভ্রমণপথগুলি সরাতে, যেমনটি Removing Inventory- এ বর্ণিত হয়েছে। মূল্য এবং প্রাপ্যতা আপডেট করার জন্য লেনদেন বার্তা ব্যবহার করার বিষয়ে আরও তথ্যের জন্য, ইনভেন্টরি যোগ করা এবং আপডেট করা ।
একটি একক লেনদেন বার্তা এতে যেকোন সংখ্যক <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. --> <!-- Child occupancy rates should only be sent through Live pricing with context and not through Pull or Changed pricing --> <OccupancyDetails>occupancy_info</OccupancyDetails> <Rates>...</Rates> <RoomBundle>...</RoomBundle> <AllowablePointsOfSale> <PointOfSale id="landing_page_identifier"/> ... </AllowablePointsOfSale> <MilesIncluded> <NumberOfMiles>integer</NumberOfMiles> <Provider> <Text language="en" text="provider-name"> </Provider> <!-- Add Loyalty point information --> <LoyaltyCampaignID>campaign_ID</LoyaltyCampaignID> </MilesIncluded> </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> উপাদানের সমন্বয় একটি ভ্রমণপথ তৈরি করে। |
| Optional | string | অপ্রচলিত: একটি কাস্টম ক্ষেত্র সংজ্ঞায়িত করে যা আপনি একটি হোটেলের সাথে যুক্ত অতিরিক্ত ডেটা পাস করতে ব্যবহার করতে পারেন। আপনি নিম্নলিখিত উপাদান নাম দিয়ে পাঁচটি পর্যন্ত কাস্টম মান পাস করতে পারেন:
গুরুত্বপূর্ণ: আপনি | |
| <ExpirationTime> | Optional | DateTime | যে তারিখ এবং সময় মূল্য মেয়াদ শেষ বলে বিবেচিত হয় (সর্বনিম্ন 3 ঘন্টা)। আমরা সুপারিশ করি যে আপনি মেয়াদ শেষ হওয়ার টাইমস্ট্যাম্প প্রদান করবেন না যদি এটি আপনার মূল্যের কাঠামোর জন্য গুরুত্বপূর্ণ না হয়। Google মেয়াদোত্তীর্ণ কোনো মূল্য পরিবেশন করে না এবং মেয়াদ শেষ হয়ে যাওয়া কোনো ভ্রমণপথ লাইভ প্রাইসিং ক্যোয়ারী করার জন্য যোগ্য হয়ে উঠবে। |
| <MilesIncluded> | Optional | boolean | রেট ফ্রিকোয়েন্ট ফ্লায়ার মাইলস অন্তর্ভুক্ত। পরামিতি অন্তর্ভুক্ত:
দ্রষ্টব্য: |
| <Nights> | Required | integer | একটি ভ্রমণের জন্য রাতের সংখ্যা। <Nights> উপাদানের মান অবশ্যই একটি ধনাত্মক পূর্ণসংখ্যা হতে হবে। <Nights> এবং <Checkin> এর সমন্বয় একটি ভ্রমণপথ তৈরি করে। |
| <OtherFees> | Optional | float | বেস রেট এবং ট্যাক্স ছাড়া অন্যান্য ফি যা একটি রুমের চূড়ান্ত মূল্যকে প্রভাবিত করে। The <OtherFees> element takes a single required attribute, currency , that defines the three-letter currency code for the fees. For example, USD . The |
| <Occupancy> | Optional | integer | Specifies the maximum allowed occupants for this rate. When <Occupancy> appears directly under <Result> , it must specify 2 or more. <Occupancy> may be accompanied by <OccupancyDetails> , which specifies the type of guests (adults or children). If guest types are not specified, they are assumed to be adults. Consult <OccupancyDetails> for syntax and description of child elements. If the <Occupancy> element is not provided, occupancy is defaulted as 2 .Key Point : Child occupancy rates should only be sent through Live pricing with context and not through Pull or Changed pricing. Note: Contact your support team to enable the feature to send non-double occupancy prices. |
| <PackageID> | Optional | string | The unique ID of the package to map it to predefined package data. Also used to populate the PACKAGE-ID landing page variable. For more information, refer to Room Bundle metadata . It is mandatory to include |
| <Property> | Required | string | The ID of a hotel affected by the associated data (price, itinerary, Room Bundle, or metadata). The value of this element must be a string. The value of this element must match the listing <id> that you defined in your Hotel List Feed. |
| <Rates> | Optional | <Rates> | A container for one or more <Rate> blocks. Each <Rate> in <Rates> defines a different price for the room/itinerary combination. Use the Note: Within |
| <Refundable> | Optional | Object | Enables listing a rate as being fully refundable or providing a free cancellation. If not provided, no information about a refund is displayed. A refund policy at the <PackageData> level overrides the refund policy at the <Result> level. A refund policy at the <Rates> level overrides the refund policy at the <PackageData> level. Refundable pricing can also be highlighted to users through alternative options without directly modifying your transaction message schema. Learn more about Refundable rates policy . The following example shows the <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Note: We recommend setting all of the attributes. A feed status warning message is generated when one or more attributes are not set. If you don't set any attributes, the rate does not display as refundable. গুণাবলী হল:
When setting the attributes, note the following:
|
| <RoomBundle> | Optional | <RoomBundle> | A container for information on priced physical descriptions of a room, any packaging of amenities, and some purchase policy details for the given hotel and itinerary. In general, use this element to define pricing for the base room and different types of rooms within the same property. While it is possible to define Room Bundle descriptions inline, you should use a separate Transaction message to define that information. Google will store metadata so that you can reference it, rather than repeat it, in all future pricing updates. |
| <RoomID> | Optional | string | The unique ID of the room to map it to predefined room data. Also used to populate the PARTNER-ROOM-ID landing page variable. For more information, refer to Room Bundle metadata . It is mandatory to include |
| <Tax> | Optional | float | The taxes that are calculated for the final price of a room. The <Tax> element takes a single required attribute, currency , that defines the three-letter currency code for the taxes. For example, USD . The <Tax> element is required if <Baserate> is greater than zero. If |
| <Unavailable> | Optional | Object | Indicates that the itinerary is unavailable for booking. Serves as a container for more detailed reasons why the itinerary was unavailable. One or more of the following unavailability reasons may be nested underneath the <Unavailable> tag:
|
উদাহরণ
Multi-property example
The following example defines one itinerary and its pricing for two properties:
<?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>
<MilesIncluded>
<NumberOfMiles>1200</NumberOfMiles>
<Provider>
<Text language="en" text="United Airlines"/>
</Provider>
<LoyaltyCampaignID>my_campaign</LoyaltyCampaignID>
</MilesIncluded>
</Result>
</Transaction>
Not shown in this example are details about the room, such as a description, a picture and caption, the room's name, and its capacity.
You can define that information once in a separate Transaction message that Google stores. You can then reference it in all subsequent pricing and inventory updates. For more information, refer to Room Bundle metadata .
Multi-rate example
The following example defines a single itinerary and property with multiple rates for various occupancies. The <Rates> element can be utilized to provide multi-rate pricing for a specific property. The following example is also useful for Vacation Rental (VR) properties:
<?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>
Unavailable example
The following example defines one itinerary whose availability couldn't be retrieved from downstream channels, a second that is both below the minimum night stay and already booked for the specified dates, and a third whose property is closed on the arrival date, but that opens during the course of the stay:
<?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>
A container for one or more <Rate> blocks. Each <Rate> in <Rates> defines a different price for the room or itinerary combination.
Use the <Rates> element only when there are multiple rates for the same room or itinerary combination. For example, you define multiple rates for conditional rates , private rates , or conditional rates in Room Bundles .
The <Rates> element appears in the following place in the Transaction message XML hierarchy:
+<Transaction>+<PropertyDataSet>// Room and package metadata + <Property> +<RoomData>+<PackageData>+<Result>// Pricing and availability +<Rates>+<RoomBundle>(Can also contain<Rates>) + ...
Values set in a <Rate> override pricing-related values on the parent <Result> or <RoomBundle> element. If they are not set in <Rate> , they inherit their value from the parent element. Only <AllowablePointsofSale> is inherited to the <RoomBundle> element.
সিনট্যাক্স
The <Rates> element uses the following syntax:
<?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> ... <MilesIncluded> <NumberOfMiles>integer</NumberOfMiles> <Provider> <Text language="en" text="provider-name"> </Provider> <LoyaltyCampaignID>campaign_ID</LoyaltyCampaignID> </MilesIncluded> ... </Rate> ... </Rates> </Result> ... </Transaction>
গুণাবলী
The <Rates> element has the following attributes:
| বৈশিষ্ট্য | প্রয়োজন? | বর্ণনা |
|---|---|---|
| rate_rule_id | Optional | For conditional rates , this ID matches a rate to a definition in your Rate Rule Definition file. The character limit for this field is 40 characters. |
শিশু উপাদান
The <Rates> element has the following child elements:
| শিশু উপাদান | প্রয়োজন? | টাইপ | বর্ণনা |
|---|---|---|---|
| <AllowablePointsOfSale> | Optional | Object | One or more landing pages that are eligible for the hotel. This element uses the same syntax as the <AllowablePointsOfSale> on <Result> . |
| <Baserate> | Required | float | The price of the room for the stay. This element uses the same syntax as the <Baserate> on <Result> . Note: The |
| <ChargeCurrency> | Optional | enum | When and where the user pays for a booking. This element uses the same syntax as a <ChargeCurrency> in a <Result> . |
| Optional | string | Deprecated: Custom fields that you can use to pass additional data associated with a hotel to a landing page. This element uses the same syntax as a <Custom[1‑5]> in a <Result> . There is a limit of 200 characters per custom field. For more information, refer to landing page files . If <Custom> elements are provided in the <Result> element, then they are not inherited in the <RoomBundle> element and should be defined separately for each <RoomBundle> or it can be included in <PackageData> if needed. Important: Contact your Technical Account Manager (TAM) if you want to use | |
| <ExpirationTime> | Optional | DateTime | The date and time at which the rate is considered expired. This element uses the same syntax as an <ExpirationTime> in a <Result> . |
| <MilesIncluded> | Optional | boolean | Rate includes frequent flyer miles. Parameters include:
Note: |
| <Occupancy> | Optional | integer | Specifies the maximum allowed occupants for this rate. If not specified, it is assumed to be the same as parent rate. |
| <OtherFees> | Required | float | Fees other than the base rate and taxes that influence the final price of a room. This element uses the same syntax as <OtherFees> in a <Result> . If |
| <Refundable> | Optional | Object | Enables listing a rate as being fully refundable or providing a free cancellation. If not provided, no information about a refund is displayed. A refund policy at the <PackageData> level overrides the refund policy at the <Result> level. A refund policy at the <Rates> level overrides the refund policy at the <PackageData> level. Refundable pricing can also be highlighted to users through alternative options without directly modifying your transaction message schema. Learn more about these options Refundable rates policy . The following example shows the <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Note: We recommend setting all of the attributes. A feed status warning message is generated when one or more attributes are not set. If you don't set any attributes, the rate does not display as refundable. গুণাবলী হল:
When setting the attributes, note the following:
|
| <Tax> | Required | float | The taxes that are calculated for the final price of a room. This element uses the same syntax as the a <Tax> in a <Result> . |
উদাহরণ
Base rate and conditional rate
The following example shows a Transaction message that contains a base rate and a conditional rate :
<?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>
</Rate>
</Rates>
</Result>
</Transaction>
Multiple conditional rates
The following example defines a base rate and multiple conditional rates within a <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 and it should be within 50 characters in length for optimal
performance. 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>
<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>
</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>
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>
<RoomBundle>
Defines pricing and availability for Room Bundles as a child of <Result> in a <Transaction> message. Define a separate element for each package or itinerary combination. To define the package and terms of the Room Bundles, use <RoomData> .
The <RoomBundle> element appears in the following place in the Transaction message XML hierarchy:
+<Transaction>+<PropertyDataSet>// Room and package metadata + <Property> +<RoomData>+<PackageData>+<Result>// Pricing and availability +<Rates>+<RoomBundle>+ ...
For more information, refer to Using Room Bundles .
সিনট্যাক্স
The <RoomBundle> element uses the following syntax:
<?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> <!-- Add Loyalty point information --> <MilesIncluded> <NumberOfMiles>integer</NumberOfMiles> <Provider> <Text language="en" text="provider-name"> </Provider> <LoyaltyCampaignID>campaign_ID</LoyaltyCampaignID>> </MilesIncluded> <!-- 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> </RoomBundle> ... </Result> </Transaction>
গুণাবলী
The <RoomBundle> element has no attributes.
শিশু উপাদান
The <RoomBundle> element has the following child elements:
| শিশু উপাদান | প্রয়োজন? | টাইপ | বর্ণনা |
|---|---|---|---|
| <Baserate> | Required | float | Defines the price of the Room Bundle for the stay. This element uses the same syntax as <Baserate> in <Result> , with the following exception:
|
| <BreakfastIncluded> | Optional | boolean | Specifies whether this Room Bundle includes breakfast with the rate. |
| <ChargeCurrency> | Optional | enum | When and where the user pays for a booking. This element uses the same syntax as <ChargeCurrency> in a <Result> . The default value is |
| Optional | string | Deprecated: Custom fields for passing additional data to the landing pages for the Room Bundle. These elements use the same syntax as <Custom[1-5]> in <Result> . There is a limit of 200 characters per custom field. For more information, refer to landing page files . Custom variables are listed only when you send the prices in the Transaction message. If <Custom> elements are provided in the <Result> element, then they are not inherited in the <RoomBundle> element and should be defined separately for each <RoomBundle> or it can be included in <PackageData> if needed. Important: Contact your Technical Account Manager (TAM) if you want to use | |
| <InternetIncluded> | Optional | boolean | If a Room Bundle includes internet access at no charge, while other bundles wouldn't include that amenity. Don't set this element for Room Bundles in a hotel that provides free internet to all rooms. This element does not apply to in-room wired internet or wireless internet that is not available in guest rooms. |
| <MilesIncluded> | Optional | boolean | Rate includes frequent flyer miles. Parameters include:
Note: |
| <Occupancy> | Required | integer | Specifies the maximum allowed occupants for this rate. For example, a large suite might be able to physically accommodate 6 guests, but the "Honeymoon Package" allows 2 guests only. This value must be less than or equal to the When defining occupancy in your landing page URL, use the The value of নোট :
|
| <OtherFees> | Required | float | Fees other than the base rate and taxes that influence the final price of a room. The <OtherFees> element takes a single required attribute, currency , that defines the three-letter currency code for the fees. For example, use USD for US dollars. |
| <PackageID> | Optional (recommended) | string | The unique ID for the package data. Use this ID to match the Room Bundle data with what was sent in <PackageData> . For more information, refer to Room Bundle metadata . (You can also use this ID to reference a common Room Bundle definition used in a single Transaction message when defining Room Bundle data inline.) |
| <ParkingIncluded> | Optional | boolean | Whether a Room Bundle includes parking at no charge, where parking would otherwise be a paid service at this hotel. Don't specify a value for this element for a hotel that offers free parking. Valid values are |
| <RatePlanID> | Optional | string | The Rate Plan ID represents the unique identifier for a room and package combination. For example, given a <RoomID> value of 5 and a <PackageID> value of ABC, you could use a value of 5-ABC for <RatePlanID> . We strongly recommend using RatePlanID as a variable to build your dynamic landing page (formerly Point of Sale) URL.Note: RatePlanID should be within 50 characters in length for optimal performance. For more information, refer to Using Variables and Conditions . |
| <Rates> | Optional | <Rates> | Rates that override the defaults for this Room Bundle. This element uses the same syntax as <Rates> in <Result> . |
| <Refundable> | Optional | Object | Enables listing a rate as being fully refundable or providing a free cancellation. If not provided, no information about a refund is displayed. A refund policy at the <PackageData> level overrides the refund policy at the <Result> level. A refund policy at the <Rates> level overrides the refund policy at the <PackageData> level. Refundable pricing can also be highlighted to users through alternative options without directly modifying your transaction message schema. Learn more about these options Refundable rates policy . The following example shows the <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Note: We recommend setting all of the attributes. A feed status warning message is generated when one or more attributes are not set. If you don't set any attributes, the rate does not display as refundable. গুণাবলী হল:
When setting the attributes, note the following:
|
| <RoomID> | Required | string | The unique ID for the room data. Use this ID to match the Room Bundle data with what you sent in <RoomData> . For more information, refer to Room Bundle metadata . (You can also use this ID to reference a common room definition in a single Transaction message when defining room data inline.) |
| <Tax> | Required | float | The taxes that are calculated for the final price of a room. The <Tax> element takes a single required attribute, currency , that defines the three-letter currency code for the taxes. For example, use USD for US dollars. |
উদাহরণ
Single occupancy bundle
The following example defines a response with a single occupancy bundle. When a user selects 1 in the Occupancy picker, Google displays the lowest eligible price regardless of occupancy.
If a single occupancy price is not available, then Google will show the lowest double-occupancy price. Note that single occupancy prices are not live queried if double-occupancy or more prices are cached for an itinerary.
This example references predefined room and package metadata with the <RoomID> and <PackageID> elements. Use the <RoomData> and <PackageData> elements to define that information.
<!-- 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>
Two or more occupancies
The following example defines a response containing two or more occupancies.
This example references predefined room and package metadata with the <RoomID> and <PackageID> elements. Use the <RoomData> and <PackageData> elements to define that information.
<!-- 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>
Multiple room bundles
The following example sets Occupancy in multiple Room bundles to demonstrate possible hostel room pricing.
<?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>
Multiple Conditional rates
The following example defines a base rate and multiple conditional rates within a <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 and it should be within 50 characters in length for optimal
performance. 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>
<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>
</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>
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>
<OccupancyDetails>
<Occupancy> in a transaction message specifies the maximum number of guests for a room or package. <OccupancyDetails> can contain additional information such as the number and type of guests (adults or children).
When <Occupancy> and <OccupancyDetails> appear within the <Rates> element of <Result> or <RoomBundle> , it means that the rate is constrained by the occupancy details.
If you include <OccupancyDetails> in a <RoomBundle> , along with a nested <Rate> element you can't send a basic <Occupancy> within the <Rate> ; instead one of the following options is recommended:
- Omit occupancy from
<Rate>: In this case, the<Rate>inherits the<OccupancyDetails>directly from the<RoomBundle>
অথবা,
- Duplicate
<OccupancyDetails>: In this case, send additional identical<OccupancyDetails>in both the<RoomBundle>and the nested<Rate>element
সিনট্যাক্স
When <OccupancyDetails> appears, it is always preceded by <Occupancy> . Note the following syntax:
<?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>শিশু উপাদান
The <OccupancyDetails> element has the following child elements:
| শিশু উপাদান | প্রয়োজন? | টাইপ | বর্ণনা |
|---|---|---|---|
| <NumAdults> | Required | integer | The number of adult guests. Min:1, Max:20. |
| <Children> | Optional | Object | A container for one or more <Child> elements. |
| <Child age> | Optional | integer | The maximum age for this Child—for example, <Child age="17"> . |
উদাহরণ
The following examples show how <OccupancyDetails> may appear within <Results> , <RoomBundle> , or the <Rates> child element.
Result response
The following example defines one itinerary and its pricing for one property in response to a Live Pricing Query where the user specified the number and types of guests. Here, the <OccupancyDetails> -- 2 adults and one child -- are returned in <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>
Rates response
The following example defines one itinerary and its pricing for 1 adult and 1 child. Here, the <OccupancyDetails> are returned in the <Rates> element of <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>
<AllowablePointsOfSale>
<PointOfSale id="yourhotelpartnersite.com"/>
</AllowablePointsOfSale>
</Rate>
</Rates>
</Result>
</Transaction>
Room bundle
The following example defines an occupancy of 2 adults and 1 child for two nights, with a refundable rate. Here, the <OccupancyDetails> appear inside <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>
Multiple room bundles
The following example defines multiple <RoomBundle> rates that are restricted to an occupancy of 2 adults and 2 children. Here, the <OccupancyDetails> appear in the <Rates> element of <RoomBundle> .
<?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>
<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>
</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>
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>