এই পৃষ্ঠাটি 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>
</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>
<!-- NOTE: OtherFees is inherited from the above setting -->
<Custom1>ratecode123</Custom1>
</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>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 | একটি রুম বান্ডেলের জন্য নির্ধারিত সর্বাধিক সংখ্যক অতিথি। উদাহরণস্বরূপ, একটি বড় স্যুট শারীরিকভাবে 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>
<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> বার্তায় মূল্য এবং প্রাপ্যতা আপডেটের জন্য একটি ধারক।
লেনদেন বার্তা 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. --> <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 | একটি কাস্টম ক্ষেত্র সংজ্ঞায়িত করে যা আপনি একটি হোটেলের সাথে যুক্ত অতিরিক্ত ডেটা পাস করতে ব্যবহার করতে পারেন৷ আপনি নিম্নলিখিত উপাদান নাম দিয়ে পাঁচটি পর্যন্ত কাস্টম মান পাস করতে পারেন:
|
| <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> ব্লকের জন্য একটি ধারক। <Rates> -এর প্রতিটি <Rate> রুম/ভ্রমণের সংমিশ্রণের জন্য আলাদা মূল্য নির্ধারণ করে। একই রুম/ভ্রমণের সংমিশ্রণের জন্য একাধিক রেট থাকলে বা যখন দ্রষ্টব্য: |
| <Refundable> | Optional | Object | একটি হারকে সম্পূর্ণরূপে ফেরতযোগ্য হিসাবে তালিকাভুক্ত করা বা বিনামূল্যে বাতিলকরণ প্রদান করা সক্ষম করে৷ প্রদান করা না হলে, একটি ফেরত সম্পর্কে কোন তথ্য প্রদর্শিত হয়. <PackageData> স্তরে একটি ফেরত নীতি <Result> স্তরে ফেরত নীতিকে ওভাররাইড করে। <Rates> স্তরে একটি ফেরত নীতি <PackageData> স্তরে ফেরত নীতিকে ওভাররাইড করে। আপনার লেনদেনের বার্তা স্কিমা সরাসরি সংশোধন না করে বিকল্প বিকল্পগুলির মাধ্যমে ব্যবহারকারীদের কাছে ফেরতযোগ্য মূল্য নির্ধারণ করা যেতে পারে। ফেরতযোগ্য হার নীতি সম্পর্কে আরও জানুন। নিম্নলিখিত উদাহরণটি এর সমস্ত বৈশিষ্ট্য সেট সহ <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> দ্রষ্টব্য: আমরা সমস্ত বৈশিষ্ট্য সেট করার পরামর্শ দিই। যখন এক বা একাধিক বৈশিষ্ট্য সেট না করা হয় তখন একটি ফিডের স্থিতি সতর্কতা বার্তা উত্পন্ন হয়। আপনি যদি কোনও বৈশিষ্ট্য সেট না করেন তবে হারটি ফেরতযোগ্য হিসাবে প্রদর্শিত হয় না। গুণাবলী হল:
বৈশিষ্ট্যগুলি সেট করার সময়, নিম্নলিখিতগুলি নোট করুন:
|
| <RoomBundle> | Optional | <RoomBundle> | একটি ঘরের দামের শারীরিক বিবরণ, সুযোগ -সুবিধার যে কোনও প্যাকেজিং এবং প্রদত্ত হোটেল এবং ভ্রমণপথের জন্য কিছু ক্রয় নীতি বিশদ সম্পর্কিত তথ্যের জন্য একটি ধারক। সাধারণভাবে, একই সম্পত্তির মধ্যে বেস রুম এবং বিভিন্ন ধরণের কক্ষের জন্য মূল্য নির্ধারণের জন্য এই উপাদানটি ব্যবহার করুন। যদিও ঘরের বান্ডিল বিবরণ ইনলাইন সংজ্ঞায়িত করা সম্ভব, তবে সেই তথ্যটি সংজ্ঞায়িত করতে আপনার একটি পৃথক লেনদেনের বার্তা ব্যবহার করা উচিত। গুগল মেটাডেটা সঞ্চয় করবে যাতে আপনি ভবিষ্যতের সমস্ত মূল্য নির্ধারণের আপডেটগুলিতে এটি পুনরাবৃত্তি করার পরিবর্তে এটি উল্লেখ করতে পারেন। |
| <RoomID> | Optional | string | ঘরের অনন্য আইডি এটি পূর্বনির্ধারিত ঘরের ডেটাতে মানচিত্র করতে। পার্টনার-রুম-আইডি ল্যান্ডিং পৃষ্ঠার ভেরিয়েবলটি পপুলেট করতেও ব্যবহৃত হয়। আরও তথ্যের জন্য, রুম বান্ডিল মেটাডেটা দেখুন। |
| <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>
এই উদাহরণে দেখানো হয়নি ঘর সম্পর্কে বিশদ যেমন বিবরণ, একটি ছবি এবং ক্যাপশন, ঘরের নাম এবং এর ক্ষমতা।
গুগল স্টোর করে এমন একটি পৃথক লেনদেনের বার্তায় আপনি সেই তথ্যটি একবার সংজ্ঞায়িত করতে পারেন। তারপরে আপনি এটি পরবর্তী সমস্ত মূল্য এবং ইনভেন্টরি আপডেটগুলিতে উল্লেখ করতে পারেন। আরও তথ্যের জন্য, রুম বান্ডিল মেটাডেটা দেখুন।
মাল্টি-হারের উদাহরণ
নিম্নলিখিত উদাহরণটি বিভিন্ন দখলদারিত্বের জন্য একাধিক হারের সাথে একটি একক ভ্রমণপথ এবং সম্পত্তি সংজ্ঞায়িত করে। <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> এ সেট না করা হয় তবে তারা পিতামাতার উপাদান থেকে তাদের মান উত্তরাধিকারী। কেবলমাত্র <ফ্যানেবল পয়েন্টসফসেল> <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 | এক বা একাধিক ল্যান্ডিং পৃষ্ঠাগুলি যা হোটেলের জন্য যোগ্য। এই উপাদানটি <AllowablePointsOfSale> <Result> এ একই সিনট্যাক্স ব্যবহার করে। |
| <Baserate> | Required | float | থাকার জন্য ঘরের দাম। এই উপাদানটি <Result> এ <Baserate> এর মতো একই সিনট্যাক্স ব্যবহার করে। দ্রষ্টব্য: < |
| <ChargeCurrency> | Optional | enum | কখন এবং কোথায় ব্যবহারকারী বুকিংয়ের জন্য অর্থ প্রদান করে। এই উপাদানটি <Result> এ <ChargeCurrency> এর মতো একই সিনট্যাক্স ব্যবহার করে। |
| <Custom[1‑5]> | Optional | string | কাস্টম ক্ষেত্রগুলি যা আপনি কোনও হোটেলের সাথে সম্পর্কিত অতিরিক্ত ডেটা ল্যান্ডিং পৃষ্ঠায় পাস করতে ব্যবহার করতে পারেন। এই উপাদানটি <Custom[1‑5]> একটি <Result> এ একই সিনট্যাক্স ব্যবহার করে। কাস্টম ফিল্ডে 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 | যে করগুলি একটি ঘরের চূড়ান্ত মূল্যের জন্য গণনা করা হয়। এই উপাদানটি <Result> এ <Tax> এর মতো একই সিনট্যাক্স ব্যবহার করে। |
উদাহরণ
বেস রেট এবং শর্তসাপেক্ষ হার
নিম্নলিখিত উদাহরণটি একটি লেনদেনের বার্তা দেখায় যাতে একটি বেস রেট এবং শর্তসাপেক্ষ হার থাকে:
<?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>
<Transaction> বার্তায় < <Result> এর শিশু হিসাবে রুম বান্ডিলগুলির জন্য মূল্য এবং প্রাপ্যতা সংজ্ঞায়িত করে। প্রতিটি প্যাকেজ বা ভ্রমণপথের সংমিশ্রণের জন্য একটি পৃথক উপাদান সংজ্ঞায়িত করুন। প্যাকেজ এবং ঘরের বান্ডিলগুলির শর্তাদি সংজ্ঞায়িত করতে, <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 | ঘরের বান্ডিলের জন্য অবতরণ পৃষ্ঠাগুলিতে অতিরিক্ত ডেটা পাস করার জন্য কাস্টম ক্ষেত্রগুলি। এই উপাদানগুলি <Custom[1-5]> <Result> তে একই সিনট্যাক্স ব্যবহার করে। কাস্টম ফিল্ডে 200 টি অক্ষরের সীমা রয়েছে। আরও তথ্যের জন্য, ল্যান্ডিং পৃষ্ঠা ফাইলগুলি দেখুন। যদি <কাস্টম> উপাদানগুলি |
| <InternetIncluded> | Optional | boolean | যদি কোনও ঘরের বান্ডলে কোনও চার্জ ছাড়াই ইন্টারনেট অ্যাক্সেস অন্তর্ভুক্ত থাকে, অন্য বান্ডিলগুলি সেই সুযোগ -সুবিধা অন্তর্ভুক্ত করে না। সমস্ত কক্ষে বিনামূল্যে ইন্টারনেট সরবরাহ করে এমন কোনও হোটেলে রুম বান্ডিলগুলির জন্য এই উপাদানটি সেট করবেন না। এই উপাদানটি ইন-রুমের ওয়্যার্ড ইন্টারনেট বা ওয়্যারলেস ইন্টারনেটের ক্ষেত্রে প্রযোজ্য নয় যা অতিথি কক্ষগুলিতে উপলভ্য নয়। |
| <Occupancy> | Required | integer | এই হারের জন্য সর্বাধিক অনুমোদিত দখলকারীদের নির্দিষ্ট করে। উদাহরণস্বরূপ, একটি বড় স্যুট শারীরিকভাবে 6 জন অতিথিকে থাকার ব্যবস্থা করতে সক্ষম হতে পারে তবে "হানিমুন প্যাকেজ" কেবল 2 জন অতিথিকে অনুমতি দেয়। এই মানটি অবশ্যই আপনার অবতরণ পৃষ্ঠার URL এ পেশা সংজ্ঞায়িত করার সময়, ভেরিয়েবল এবং শর্তাদি ব্যবহারে বর্ণিত হিসাবে নোট :
|
| <OtherFees> | Required | float | বেস রেট এবং কর ব্যতীত অন্য ফি যা কোনও ঘরের চূড়ান্ত দামকে প্রভাবিত করে। <OtherFees> উপাদানটি একটি একক প্রয়োজনীয় বৈশিষ্ট্য, currency গ্রহণ করে, যা ফিগুলির জন্য তিন-অক্ষরের মুদ্রা কোডকে সংজ্ঞায়িত করে। উদাহরণস্বরূপ, মার্কিন ডলারের জন্য USD ব্যবহার করুন। |
| <PackageID> | Optional (recommended) | string | প্যাকেজ ডেটার জন্য অনন্য আইডি। <PackageData> এ যা প্রেরণ করা হয়েছিল তার সাথে ঘরের বান্ডিল ডেটা মেলে এই আইডিটি ব্যবহার করুন। আরও তথ্যের জন্য, রুম বান্ডিল মেটাডেটা দেখুন। (ঘরের বান্ডিল ডেটা ইনলাইন সংজ্ঞায়িত করার সময় আপনি একক লেনদেনের বার্তায় ব্যবহৃত একটি সাধারণ কক্ষের বান্ডিল সংজ্ঞাটি উল্লেখ করতে এই আইডিটিও ব্যবহার করতে পারেন)) |
| <ParkingIncluded> | Optional | boolean | কোনও ঘরের বান্ডলে বিনা চার্জে পার্কিং অন্তর্ভুক্ত রয়েছে কিনা, যেখানে পার্কিং অন্যথায় এই হোটেলে কোনও অর্থ প্রদানের পরিষেবা হবে। বিনামূল্যে পার্কিং সরবরাহ করে এমন কোনও হোটেলের জন্য এই উপাদানটির জন্য কোনও মান নির্দিষ্ট করবেন না। বৈধ মানগুলি |
| <RatePlanID> | Optional | string | রেট প্ল্যান আইডি একটি ঘর এবং প্যাকেজ সংমিশ্রণের জন্য অনন্য শনাক্তকারীকে উপস্থাপন করে। উদাহরণস্বরূপ, একটি <RoomID> 5 এর মান এবং একটি <PackageID> এবিসির মান দেওয়া, আপনি <RatePlanID> > এর জন্য 5-ABC এর মান ব্যবহার করতে পারেন। আমরা আপনার গতিশীল ল্যান্ডিং পৃষ্ঠা (পূর্বে বিক্রয় পয়েন্ট) ইউআরএল তৈরি করতে ভেরিয়েবল হিসাবে র্যাম্পপ্ল্যানিড ব্যবহার করার দৃ strongly ়ভাবে পরামর্শ দিচ্ছি।আরও তথ্যের জন্য, ভেরিয়েবল এবং শর্তাদি ব্যবহার করে দেখুন। |
| <Rates> | Optional | <Rates> | এই ঘরের বান্ডিলের জন্য ডিফল্টগুলি ওভাররাইড করে এমন হারগুলি। এই উপাদানটি <Rates> <Result> > এর মতো একই সিনট্যাক্স ব্যবহার করে। |
| <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 নির্বাচন করে, গুগল পেশা নির্বিশেষে সর্বনিম্ন যোগ্য মূল্য প্রদর্শন করে।
যদি কোনও একক পেশার মূল্য উপলব্ধ না হয় তবে গুগল সর্বনিম্ন ডাবল-টেকসইকেন্সি মূল্য প্রদর্শন করবে। নোট করুন যে একক পেশার দামগুলি যদি ডাবল-পেশা বা আরও বেশি দাম ভ্রমণপথের জন্য ক্যাশে করা হয় তবে লাইভ কোয়েরে নেই।
এই উদাহরণটি <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"> । |
উদাহরণ
<Rates> <Results> দেখায় <RoomBundle> <OccupancyDetails>
ফলাফল প্রতিক্রিয়া
নিম্নলিখিত উদাহরণটি একটি লাইভ প্রাইসিং ক্যোয়ারির প্রতিক্রিয়া হিসাবে একটি সম্পত্তির জন্য একটি ভ্রমণপথ এবং এর মূল্য নির্ধারণ করে যেখানে ব্যবহারকারী অতিথির সংখ্যা এবং প্রকারগুলি নির্দিষ্ট করে। এখানে, <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 জন প্রাপ্তবয়স্ক এবং 1 সন্তানের জন্য একটি ভ্রমণপথ এবং এর মূল্য নির্ধারণ করে। <Result> <Rates> <OccupancyDetails>
<?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>
রুম বান্ডিল
নিম্নলিখিত উদাহরণটি ফেরতযোগ্য হারের সাথে দুটি রাতের জন্য 2 জন প্রাপ্তবয়স্ক এবং 1 সন্তানের পেশা সংজ্ঞায়িত করে। <RoomBundle> , <OccupancyDetails>
<?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> হারগুলি সংজ্ঞায়িত করে যা 2 প্রাপ্তবয়স্ক এবং 2 বাচ্চাদের দখলে সীমাবদ্ধ। <RoomBundle> <Rates> <OccupancyDetails>
<?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>