অনুরোধ
সিনট্যাক্স
Transaction (Property Data)
বার্তাটি নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="timestamp"
id="message_ID"
partner="partner_key">
<PropertyDataSet action="[overlay|delta]">
<!-- (Required) ID that matches the Hotel List Feed -->
<Property>HotelID</Property>
<RoomData>
<!-- (Required) One room ID per RoomData element -->
<RoomID>RoomID</RoomID>
<Name>
<Text text="room_name" language="language_code"/>
</Name>
<Description>
<Text text="room_description" language="language_code"/>
</Description>
<!-- (Optional) Restricts the rate plans allowed for this room type to
those listed here. If specified, don't specify AllowableRoomIDs. -->
<AllowablePackageIDs>
<AllowablePackageID>PackageID</AllowablePackageID>
</AllowablePackageIDs>
<Capacity>max_number_of_occupants</Capacity>
<AdultCapacity>max_number_of_adult_occupants</AdultCapacity>
<ChildCapacity>max_number_of_child_occupants</ChildCapacity>
<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>
<JapaneseHotelRoomStyle>[western|japanese|japanese_western]</JapaneseHotelRoomStyle>
<Beds>
<Bed size="[single|semi_double|double|queen|king]">
<Width unit="cm" number="bed_width"/>
<Length unit="cm" number="bed_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>
<PackageData>
<!-- (Required) One package ID per PackageData element -->
<PackageID>PackageID</PackageID>
<Name>
<Text text="package_name" language="language_code"/>
</Name>
<Description>
<Text text="package_description" language="language_code"/>
</Description>
<!-- (Optional) Restricts the room types allowed for this rate plan to
those listed here. If specified, don't specify AllowablePackageIDs. -->
<AllowableRoomIDs>
<AllowableRoomID>RoomID</AllowableRoomID>
</AllowableRoomIDs>
<Refundable available="[false|true]" refundable_until_days="number_of_days"
refundable_until_time="time"/>
<!-- 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>
</PackageData>
</PropertyDataSet>
</Transaction>
উপাদান এবং বৈশিষ্ট্য
লেনদেন (সম্পত্তি ডেটা) বার্তায় নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:
উপাদান / @Attribute | ঘটনা | টাইপ | বর্ণনা |
---|---|---|---|
Transaction | 1 | Complex element | একটি ARI বাস্তবায়নে, এটি একটি বার্তার মূল উপাদান যা একটি একক সম্পত্তির জন্য রুমের ধরন এবং প্যাকেজ নির্ধারণ করে। |
Transaction / @timestamp | 1 | DateTime | এই বার্তা তৈরির তারিখ এবং সময়। |
Transaction / @id | 1 | string | এই অনুরোধ বার্তার জন্য একটি অনন্য শনাক্তকারী৷ এই মান প্রতিক্রিয়া বার্তা ফেরত দেওয়া হয়. অনুমোদিত অক্ষর হল az, AZ, 0-9, _ (আন্ডারস্কোর), এবং - (ড্যাশ)। |
Transaction / @partner | 1 | string | এই বার্তার জন্য অংশীদার অ্যাকাউন্ট. এই স্ট্রিং মান হল হোটেল সেন্টারের অ্যাকাউন্ট সেটিংস পৃষ্ঠায় তালিকাভুক্ত "অংশীদার কী" মান। দ্রষ্টব্য: আপনার যদি একটি ব্যাকএন্ড থাকে যা একাধিক অ্যাকাউন্টের জন্য ফিড প্রদান করে, তাহলে এই মানটিকে একই অ্যাকাউন্টের জন্য আপনার |
Transaction / PropertyDataSet | 1.. | PropertyDataSet | একটি একক সম্পত্তির জন্য রুমের ধরন এবং প্যাকেজগুলি সংজ্ঞায়িত করার জন্য একটি ধারক৷ |
Transaction / PropertyDataSet / @action | 0..1 | enum | রুম রেট সংজ্ঞায় প্রযোজ্য আপডেটের ধরন। বৈধ মান হল:
এই বৈশিষ্ট্যটি ঐচ্ছিক এবং নির্দিষ্ট না থাকলে |
Transaction / PropertyDataSet / Property | 1 | string | সম্পত্তির অনন্য শনাক্তকারী। এই মানটি অবশ্যই হোটেল তালিকা ফিডে <listing> এলিমেন্টে <id> ব্যবহার করে নির্দিষ্ট হোটেল আইডির সাথে মিলতে হবে। হোটেল আইডিটি হোটেল সেন্টারেও তালিকাভুক্ত করা হয়েছে। |
Transaction / PropertyDataSet / RoomData | 0..n | RoomData | একটি ঘরের বর্ণনা দেয়। দ্রষ্টব্য: অন্তত একটি |
Transaction / PropertyDataSet / RoomData / RoomID | 1 | RoomID | এক ধরনের রুমের জন্য একটি অনন্য শনাক্তকারী। এই মানটি <OTA_HotelAvailNotifRQ> , <OTA_HotelRateAmountNotifRQ> এবং <OTA_HotelInvCountNotifRQ> বার্তাগুলিতে <StatusApplicationControl> উপাদানের InvTypeCode বৈশিষ্ট্য ব্যবহার করে উল্লেখ করা হয়েছে। |
Transaction / PropertyDataSet / RoomData / Name | 1 | Name | এক বা একাধিক ভাষায় রুমের বিভাগের নামের জন্য ধারক। |
Transaction / PropertyDataSet / RoomData / Name / Text | 1..n | Text | একটি ভাষায় রুমের বিভাগের নাম উল্লেখ করে। |
Transaction / PropertyDataSet / RoomData / Name / Text / @text | 1..n | string | language বৈশিষ্ট্য দ্বারা নির্দিষ্ট ভাষায় রুমের বিভাগের নাম। |
Transaction / PropertyDataSet / RoomData / Description | 1 | Name | এক বা একাধিক ভাষায় রুমের শ্রেণীবিভাগের বর্ণনার জন্য ধারক। |
Transaction / PropertyDataSet / RoomData / Description / Text | 1..n | Text | একটি ভাষায় ঘরের বিভাগের বিবরণ নির্দিষ্ট করে। |
Transaction / PropertyDataSet / RoomData / Description / Text / @text | 1..n | string | language বৈশিষ্ট্য দ্বারা নির্দিষ্ট ভাষায় রুমের বিভাগের বিবরণ। |
Transaction / PropertyDataSet / RoomData / Description / Text / @language | 1..n | string | একটি দুই-অক্ষরের ভাষা কোড । |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs | 0..1 | AllowablePackageIDs | <AllowablePackageID> উপাদানগুলির জন্য একটি ধারক। যদি যদি |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID | 1..n | AllowablePackageID | একটি রেট প্ল্যানের প্যাকেজআইডি নির্দিষ্ট করে যা এই রুমের প্রকারের সাথে একত্রিত করা যেতে পারে। একটি হার পরিকল্পনা প্যাকেজ, হার এবং প্রাপ্যতার সংমিশ্রণ দ্বারা সংজ্ঞায়িত করা হয়। PackageID OTA_HotelRateAmountNotifRQ এবং OTA_HotelAvailNotifRQ বার্তাগুলির RatePlanCode এর সাথে মিলে যায়৷ |
Transaction / PropertyDataSet / RoomData / Capacity | 0..1 | integer | একটি কক্ষ শারীরিকভাবে মিটমাট করতে পারে এমন সর্বাধিক সংখ্যক প্রাপ্তবয়স্ক এবং শিশুদের। এটি আপনার রেট সহ যেকোন NumberOfGuests মানের চেয়ে বেশি বা সমান হওয়া উচিত। দ্রষ্টব্য: যদি |
Transaction / PropertyDataSet / RoomData / AdultCapacity | 0..1 | integer | একটি কক্ষ শারীরিকভাবে মিটমাট করতে পারে এমন সর্বাধিক সংখ্যক প্রাপ্তবয়স্ক। এটি আপনার রেট সহ যেকোন NumberOfGuests মানের চেয়ে বেশি বা সমান হওয়া উচিত। |
Transaction / PropertyDataSet / RoomData / ChildCapacity | 0..1 | integer | একটি রুম শারীরিকভাবে মিটমাট করতে পারে যে সর্বাধিক সংখ্যক শিশু। |
Transaction / PropertyDataSet / RoomData / OccupancySettings | 0..1 | OccupancySettings | সেটিংস যা একটি রুমের দখলের প্রয়োজনীয়তা সীমাবদ্ধ বা পরিবর্তন করতে পারে।
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> সমস্ত শিশু উপাদান অন্তর্ভুক্ত করার প্রয়োজন নেই। |
Transaction / PropertyDataSet / RoomData / PhotoURL | 0..n | PhotoURL | প্রদত্ত রুম বা রুম বান্ডেলের একটি ছবির জন্য একটি URL এবং ঐচ্ছিক ক্যাপশন৷ আপনি একটি রুম বা রুম বান্ডেলের জন্য একাধিক <PhotoURL> নির্দিষ্ট করতে পারেন।এই উপাদানটি নিম্নলিখিত শিশু উপাদান গ্রহণ করে:
<PhotoURL> <URL>http://www.example.com/image1.jpg</URL> <Caption> <Text text="A bright way to enjoy your mornin' cuppa tea." language="en"/> <Text text="Une façon lumineuse pour profiter de votre tasse de thé." language="fr"/> </Caption> </PhotoURL> |
Transaction / PropertyDataSet / RoomData / RoomFeatures | 0..1 | <RoomFeatures> | রুম বৈশিষ্ট্য সম্পর্কে তথ্য রয়েছে. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / JapaneseHotelRoomStyle | 0..1 | enum | একটি জাপানি হোটেল রুমের শৈলী নির্দেশ করে। বৈধ মান হল:
|
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds | 0..1 | Object | ঘরে যতগুলি <Bed> আছে ততগুলি রয়েছে। অনুগ্রহ করে মনে রাখবেন যে জাপানি ফুটন এখানে গণনা করা উচিত নয়। প্রতিটি
<Bed> নিম্নলিখিত শিশু উপাদান রয়েছে:
<Beds> <Bed size="double"> <Width unit="cm" number="140"/> <Length unit="cm" number="195"/> </Bed> <Bed/> <!-- Size unknown --> </Beds> |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Suite | 0.. | enum | এই রুম একটি স্যুট হলে এই উপাদান প্রদান করুন. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Capsule | 0..1 | enum | এই রুমটি একটি ক্যাপসুল রুম হলে এই উপাদানটি প্রদান করুন। |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Roomsharing | 0..1 | enum | এই রুমটি অন্য বাসিন্দা যেমন মালিক বা অন্য অতিথিদের সাথে শেয়ার করা হয়েছে কিনা। বৈধ মানগুলি shared এবং private । |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Outdoor | 0..1 | enum | এই উপাদানটি প্রদান করুন যখন এই ঘরটি বাইরে থাকার জায়গা যেখানে নির্দিষ্ট দেয়াল, প্লাম্বিং এবং জলবায়ু নিয়ন্ত্রণ নেই। উদাহরণ স্বরূপ, হোটেলের কক্ষগুলি আউটডোর লজিং নয় যেখানে ক্যাম্পসাইটগুলি যেখানে অতিথিরা তাঁবুতে থাকেন এবং আরভি পার্ক যেখানে অতিথিরা তাদের নিজস্ব আরভি নিয়ে আসেন তা হল আউটডোর লজিং৷ |
Transaction / PropertyDataSet / RoomData / RoomFeatures / MobileAccessible | 0..1 | enum | এই রুমটি চলাফেরার জন্য অ্যাক্সেসযোগ্য হলে এই উপাদানটি প্রদান করুন। |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Smoking | 0..1 | enum | এই রুমটি একটি ধূমপানমুক্ত রুম বা একটি ধূমপান রুম কিনা। বৈধ মান হল non_smoking এবং smoking । |
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet | 0..1 | Object | রুমে একটি স্নান এবং টয়লেট সম্পর্কে তথ্য রয়েছে। বৈশিষ্ট্য হল:
উপাদানটি ঐচ্ছিকভাবে নিম্নলিখিত শিশু উপাদানগুলি গ্রহণ করে:
উদাহরণ: <BathAndToilet relation="separate"> <Bath bathtub="1" shower="1"/> <Toilet electronic_bidet="1" mobility_accessible="1"/> </BathAndToilet> |
Transaction / PropertyDataSet / RoomData / RoomFeatures / OpenAirBath | 0..1 | enum | যখন এই রুমে একটি ব্যক্তিগত ওপেন-এয়ার স্নান থাকে তখন এই উপাদানটি প্রদান করুন। |
Transaction / PropertyDataSet / RoomData / RoomFeatures / AirConditioning | 0..1 | enum | এই রুমে এয়ার কন্ডিশনার থাকলে এই উপাদানটি প্রদান করুন। |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Balcony | 0..1 | enum | যখন এই রুমে একটি বারান্দা বা লানাই থাকে তখন এই উপাদানটি প্রদান করুন। |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Views | 0..1 | Object | বৈধ বিকল্প অন্তর্ভুক্ত: |
Transaction / PropertyDataSet / PackageData | 0..n | PackageData | রেট বৈশিষ্ট্য এবং শর্তাবলী বর্ণনা করে এমন উপাদানগুলির জন্য কন্টেইনার যা শারীরিক কক্ষের বিবরণের অংশ নয়। দ্রষ্টব্য: অন্তত একটি |
Transaction / PropertyDataSet / PackageData / PackageID | 1 | string | এই বার্তাগুলির PackageID OTA_HotelRateAmountNotifRQ এবং OTA_HotelAvailNotifRQ বার্তাগুলির RatePlanCode এর সাথে মিলে যায়৷ |
Transaction / PropertyDataSet / PackageData / Name | 1 | Name | এক বা একাধিক ভাষায় প্যাকেজের নামের জন্য ধারক। |
Transaction / PropertyDataSet / PackageData / Name / Text | 1..n | Text | একটি ভাষায় প্যাকেজের নাম উল্লেখ করে। |
Transaction / PropertyDataSet / PackageData / Name / Text / @text | 1..n | string | language বৈশিষ্ট্য দ্বারা নির্দিষ্ট ভাষায় প্যাকেজের নাম। |
Transaction / PropertyDataSet / PackageData / Description | 1 | Description | এক বা একাধিক ভাষায় প্যাকেজের বর্ণনার জন্য ধারক। |
Transaction / PropertyDataSet / PackageData / Description / Text | 1..n | Text | একটি ভাষায় প্যাকেজের বর্ণনা নির্দিষ্ট করে। |
Transaction / PropertyDataSet / PackageData / Description / Text / @text | 1..n | string | language বৈশিষ্ট্য দ্বারা নির্দিষ্ট ভাষায় প্যাকেজের বর্ণনা। |
Transaction / PropertyDataSet / PackageData / Description / Text / @language | 1..n | string | একটি দুই-অক্ষরের ভাষা কোড । |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs | 0..1 | AllowableRoomIDs | <AllowableRoomID> উপাদানগুলির জন্য একটি ধারক। যদি |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID | 1..n | AllowableRoomID | এই রেট প্ল্যানের সাথে একত্রিত করা যেতে পারে এমন একটি রুম টাইপের RoomID নির্দিষ্ট করে। <RoomData> এলিমেন্টে রুমের ধরন সংজ্ঞায়িত করা হয়েছে। |
Transaction / PropertyDataSet / PackageData / Refundable | 0..1 | Refundable | একটি হারকে সম্পূর্ণরূপে ফেরতযোগ্য বা বাতিলযোগ্য হিসাবে তালিকাভুক্ত করতে সক্ষম করে৷ প্রদান করা না হলে, একটি ফেরত সম্পর্কে কোন তথ্য প্রদর্শিত হয়. দ্রষ্টব্য: আমরা সমস্ত বৈশিষ্ট্য সেট করার পরামর্শ দিই। যখন এক বা একাধিক বৈশিষ্ট্য সেট করা না থাকে তখন একটি ফিড স্ট্যাটাস সতর্কতা বার্তা তৈরি হয়। আপনি কোনো বৈশিষ্ট্য সেট না করলে, হার ফেরতযোগ্য হিসাবে প্রদর্শিত হবে না। বৈশিষ্ট্যগুলি সেট করার সময়, নিম্নলিখিতগুলি নোট করুন:
|
Transaction / PropertyDataSet / PackageData / Refundable / @available | 1 | boolean | (প্রয়োজনীয়) রেট পূর্ণ ফেরতের অনুমতি দেয় কিনা তা নির্দেশ করতে 1 বা true সেট করুন; অন্যথায় 0 বা false সেট করুন। |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days | 0..1 | integer | (প্রয়োজনীয় যদি available true ) refundable_until_days মান অবশ্যই 0 এবং 330 এর মধ্যে একটি পূর্ণসংখ্যা হতে হবে, অন্তর্ভুক্ত। |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_time | 0.. | Time | ( available true হলে অত্যন্ত প্রস্তাবিত) হোটেলের স্থানীয় সময়ে দিনের সর্বশেষ সময় নির্দিষ্ট করে, যে একটি সম্পূর্ণ ফেরতের অনুরোধকে সম্মানিত করা হবে। এটি নির্দিষ্ট করার জন্য refundable_until_days এর সাথে একত্রিত করা যেতে পারে, উদাহরণস্বরূপ, "চেক-ইন করার দুই দিন আগে 4:00PM পর্যন্ত ফেরত পাওয়া যায়"। যদি refundable_until_time সেট করা না থাকে, মানটি মধ্যরাত পর্যন্ত ডিফল্ট হয়। |
Transaction / PropertyDataSet / PackageData / BreakfastIncluded | 0..1 | boolean | এই রুমের প্রকারে প্রাতঃরাশ অন্তর্ভুক্ত কিনা তা নির্দিষ্ট করে। বৈধ মান হল 0 (বা false ) এবং 1 (বা true )। আপনি |
Transaction / PropertyDataSet / PackageData / CheckinTime | 0..1 | Time | হোটেলের স্থানীয় সময় যত তাড়াতাড়ি সম্ভব চেক-ইন সময়। সময় 24:00 এর কম হতে হবে। |
Transaction / PropertyDataSet / PackageData / CheckoutTime | 0..1 | Time | হোটেলের স্থানীয় সময়ে সর্বশেষ সম্ভাব্য চেক-আউট সময়। |
Transaction / PropertyDataSet / PackageData / InternetIncluded | 0..1 | boolean | রুমটিতে বিনামূল্যে ইন্টারনেট অ্যাক্সেস রয়েছে কিনা তা নির্দিষ্ট করে যখন অন্যান্য রুমে এই সুবিধা অন্তর্ভুক্ত নয়। এই উপাদানটি এমন কোনও হোটেলে সেট করবেন না যা সমস্ত রুমে বিনামূল্যে ইন্টারনেট সরবরাহ করে। এই উপাদানটি ঘরের মধ্যে তারযুক্ত ইন্টারনেট বা গেস্ট রুমে উপলব্ধ নয় এমন বেতার ইন্টারনেটের ক্ষেত্রে প্রযোজ্য নয়। বৈধ মান হল 0 (বা false ) এবং 1 (বা true )। |
Transaction / PropertyDataSet / PackageData / Meals | 0..1 | Object | এই প্যাকেজে খাবার সম্পর্কে তথ্য রয়েছে।
ঐচ্ছিক বৈশিষ্ট্যগুলি ব্যবহার করা হয় শুধুমাত্র যখন খাবারের ফিল্টারগুলির জন্য ( |
Transaction / PropertyDataSet / PackageData / ParkingIncluded | 0..1 | boolean | কোনও রুমে কোনও চার্জ ছাড়াই পার্কিং অন্তর্ভুক্ত আছে কিনা, যেখানে পার্কিং অন্যথায় এই হোটেলে একটি অর্থপ্রদানের পরিষেবা হবে। বিনামূল্যে পার্কিং অফার করে এমন হোটেলের জন্য এই উপাদানটির জন্য একটি মান নির্দিষ্ট করবেন না। বৈধ মান হল 0 (বা false ) এবং 1 (বা true )। ডিফল্ট মান false । |
Transaction / PropertyDataSet / PackageData / PhotoURL | 0..1 | Object | ( <RoomData> এ <PhotoURL> এর মতোই, কিন্তু প্যাকেজের জন্য (যেমন খাবারের ছবি)। |
উদাহরণ
রুম এবং প্যাকেজ ডেটা
একটি লেনদেন (সম্পত্তি ডেটা) বার্তায় একটি সম্পত্তির রুম এবং প্যাকেজ ডেটা কীভাবে সংজ্ঞায়িত করা যায় তার একটি প্রাথমিক উদাহরণ নিম্নলিখিত। overlay
অ্যাট্রিবিউটটি নিশ্চিত করতে ব্যবহার করা হয় যে, যদি কোনো ডেটা অপ্রত্যাশিতভাবে ইতিমধ্যেই বিদ্যমান থাকে, তাহলে বিদ্যমান সমস্ত ডেটা মুছে ফেলা হবে এবং এই বার্তার ডেটা দিয়ে প্রতিস্থাপিত হবে:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<PropertyDataSet action="overlay">
<Property>Property_1</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<Name>
<Text text="King" language="en"/>
</Name>
<Description>
<Text text="Room with a king bed" language="en"/>
</Description>
<Capacity>2</Capacity>
<PhotoURL>
<URL>http://www.foo.com/static/bar/image.jpg</URL>
<Caption>
<Text text="Room with a king bed" language="en"/>
</Caption>
</PhotoURL>
</RoomData>
<RoomData>
<RoomID>RoomID_2</RoomID>
<Name>
<Text text="Double" language="en"/>
</Name>
<!-- Additional RoomData child elements omitted. -->
</RoomData>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Standard" language="en"/>
</Name>
<Description>
<Text text="Standard rate" language="en"/>
</Description>
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>0</BreakfastIncluded>
</PackageData>
<PackageData>
<PackageID>PackageID_2</PackageID>
<Name>
<Text text="Free Breakfast" language="en"/>
</Name>
<Description>
<Text text="Free breakfast rate" language="en"/>
</Description>
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
একটি রুমের ধরন যোগ করুন
বিদ্যমান <Transaction>
ডেটাতে কীভাবে একটি রুমের ধরন এবং প্যাকেজ যোগ করতে হয় তার একটি উদাহরণ নিচে দেওয়া হল:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-07-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<PropertyDataSet action="delta">
<Property>Property_1</Property>
<RoomData>
<RoomID>RoomID_3</RoomID>
<Name>
<Text text="Queen" language="en"/>
</Name>
<!-- Additional RoomData child elements omitted. -->
</RoomData>
<PackageData>
<PackageID>PackageID_3</PackageID>
<Name>
<Text text="Non-Refundable" language="en"/>
</Name>
<!-- Additional PackageData child elements omitted. -->
<Refundable available="false"/>
</PackageData>
</PropertyDataSet>
</Transaction>
রুমের প্রকারগুলি সরান
বিদ্যমান রুমের ধরন এবং প্যাকেজগুলি কীভাবে সরানো যায় তার একটি উদাহরণ নিচে দেওয়া হল। এই পরিস্থিতিতে, "রুম এবং প্যাকেজ ডেটা" এবং "একটি রুমের ধরন যোগ করুন" এর মেসেজগুলি আগে Google-এ পাঠানো হলে, Google দেখানো মেসেজ পাওয়ার পরে King
এবং Double
রুমের ধরন আর থাকবে না। মনে রাখবেন যে প্যাকেজ ডেটা অপসারণ লেনদেন (সম্পত্তি ডেটা), OTA_HotelRateAmountNotifRQ, এবং OTA_HotelAvailNotifRQ
বার্তাগুলি (একই PackageID
মান উল্লেখ করে) জুড়ে সংজ্ঞায়িত সামগ্রিক হার পরিকল্পনাকে প্রভাবিত করে এবং এইভাবে অন্যান্য বার্তার প্রকারগুলি ব্যবহার করে সংশ্লিষ্ট আপডেটগুলিকে প্রতিফলিত করার জন্য PackageID_2
এর প্রয়োজন হতে পারে। PackageID_3
এখানে আর সংজ্ঞায়িত করা হয়নি৷
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-08-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<PropertyDataSet action="overlay">
<Property>Property_1</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<Name>
<Text text="Queen" language="en"/>
</Name>
<!-- Additional RoomData child elements omitted. -->
<Capacity>2</Capacity>
<PhotoURL>
<URL>http://www.foo.com/static/bar/image.jpg</URL>
<Caption>
<Text text="Room with a queen bed" language="en"/>
</Caption>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Refundable" language="en"/>
</Name>
<!-- Additional PackageData child elements omitted. -->
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>0</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
হার পরিকল্পনা সীমাবদ্ধ
নিচের একটি উদাহরণ হল কিভাবে <AllowablePackageIDs>
উপাদান ব্যবহার করে রুমের প্রকারের জন্য অনুমোদিত রেট প্ল্যানগুলিকে সীমাবদ্ধ করতে। এই উদাহরণে, Queen
রুমের ধরন ( RoomID_2
) শুধুমাত্র প্যাকেজ ID_1 হিসাবে চিহ্নিত প্যাকেজ এবং রেট প্ল্যানের সাথে মিলিত হতে পারে৷
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-12-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<PropertyDataSet action="overlay">
<Property>Property_1</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<Name>
<Text text="King" language="en"/>
</Name>
<!-- Additional RoomData child elements omitted. -->
</RoomData>
<RoomData>
<RoomID>RoomID_2</RoomID>
<Name>
<Text text="Queen" language="en"/>
</Name>
<AllowablePackageIDs>
<AllowablePackageID>PackageID_1</AllowablePackageID>
</AllowablePackageIDs>
<!-- Additional RoomData child elements omitted. -->
</RoomData>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Standard" language="en"/>
</Name>
<!-- Additional PackageData child elements omitted. -->
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>0</BreakfastIncluded>
</PackageData>
<PackageData>
<PackageID>PackageID_2</PackageID>
<Name>
<Text text="Free Breakfast" language="en"/>
</Name>
<!-- Additional PackageData child elements omitted. -->
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
রুম ক্ষমতা সীমিত
নিচের একটি উদাহরণ হল কিভাবে <Capacity>
, <AdultCapacity>
, <ChildCapacity>
উপাদানগুলি রুমের ক্ষমতার উপর সীমাবদ্ধতা সেট করতে ব্যবহার করতে হয়।
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-12-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<PropertyDataSet action="overlay">
<Property>Property_1</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<Name>
<Text text="Double" language="en"/>
</Name>
<Capacity>4</Capacity>
<AdultCapacity>4</AdultCapacity>
<ChildCapacity>3</ChildCapacity>
<!-- Additional RoomData child elements omitted. -->
</RoomData>
</PropertyDataSet>
</Transaction>
ডাবল রুমের প্রকারে (RoomID_1) মোট 4 জন অতিথি থাকতে পারে৷ উপরন্তু, এটি 4 প্রাপ্তবয়স্ক এবং 3 পর্যন্ত শিশু থাকতে পারে। এই রুম বুক করার জন্য তিনটি ক্ষমতার প্রয়োজনীয়তা অবশ্যই সন্তুষ্ট হতে হবে। এই কনফিগারেশনটি দুটি শয্যা বিশিষ্ট একটি সাধারণ ঘরের প্রতিনিধি যা প্রতিটিতে দুটি লোকের জন্য উপযুক্ত। শিশুর ধারণক্ষমতা মোট ক্ষমতার চেয়ে এক কম কারণ ঘরে অন্তত একজন প্রাপ্তবয়স্ক থাকতে হবে।
<RoomFeatures>
এবং খাবার সহ বর্ধিত উদাহরণ
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>
খাবার
নিম্নলিখিত উদাহরণটি খাবার, ফটো এবং চেক-ইন এবং চেক-আউট সময়ের জন্য রুম এবং প্যাকেজ মেটাডেটা সংজ্ঞায়িত করে:
<?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>
প্রতিক্রিয়া
সিনট্যাক্স
TransactionResponse (Property Data)
বার্তাটি নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:
<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="timestamp"
id="message_ID"
partner="partner_key">
<!-- Either Success or Issues will be populated. -->
<Success/>
<Issues>
<Issue code="issue_code" status="issue_type">issue_description</Issue>
</Issues>
</TransactionResponse>
উপাদান এবং বৈশিষ্ট্য
TransactionResponse (Property Data)
বার্তায় নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:
উপাদান / @Attribute | ঘটনা | টাইপ | বর্ণনা |
---|---|---|---|
TransactionResponse | 1 | Complex element | একটি প্রাপ্ত লেনদেনের অনুরোধ বার্তার সফলতা বা সমস্যা নির্দেশ করে মূল উপাদান। |
TransactionResponse / @timestamp | 1 | DateTime | এই বার্তা তৈরির তারিখ এবং সময়। |
TransactionResponse / @id | 1 | string | সংশ্লিষ্ট লেনদেন বার্তা থেকে অনন্য শনাক্তকারী। |
TransactionResponse / @partner | 1 | string | এই বার্তার জন্য অংশীদার অ্যাকাউন্ট. |
TransactionResponse / Success | 0..1 | Success | নির্দেশ করে যে লেনদেন বার্তাটি সতর্কতা, ত্রুটি বা ব্যর্থতা ছাড়াই সফলভাবে প্রক্রিয়া করা হয়েছে। হয় |
TransactionResponse / Issues | 0..1 | Issues | লেনদেন বার্তা প্রক্রিয়া করার সময় এক বা একাধিক সমস্যার সম্মুখীন হওয়ার জন্য একটি ধারক। হয় |
TransactionResponse / Issues / Issue | 1..n | Issue | লেনদেন বার্তা প্রক্রিয়া করার সময় একটি সতর্কতা, ত্রুটি বা ব্যর্থতার বর্ণনা। এই বিষয়গুলির বিশদ বিবরণ ফিড স্ট্যাটাস ত্রুটি বার্তাগুলিতে পাওয়া যাবে। |
TransactionResponse / Issues / Issue / @code | 1 | integer | সমস্যাটির শনাক্তকারী। |
TransactionResponse / Issues / Issue / @status | 1 | enum | যে ধরনের সমস্যার সম্মুখীন হয়েছে। বৈধ মান হল |
উদাহরণ
সফলতা
নিম্নলিখিতটি একটি সফলভাবে প্রক্রিয়াকৃত লেনদেন বার্তার প্রতিক্রিয়া।
<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<Success/>
</TransactionResponse>
ইস্যু
নিম্নলিখিত একটি লেনদেন বার্তার একটি প্রতিক্রিয়া যা ত্রুটির কারণে প্রক্রিয়া করা হয়নি৷
<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<Issues>
<Issue code="1001" status="error">Example</Issue>
</Issues>
</TransactionResponse>