İstekler
Söz dizimi
Transaction (Property Data)
mesajında aşağıdaki söz dizimi kullanılır:
<?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>
Öğeler ve Özellikler
Transaction (Tesis Verileri) mesajında aşağıdaki öğeler bulunur ve özellikler:
Öğe / @Özellik | Yineleme sayısı | Tür | Açıklama |
---|---|---|---|
Transaction | 1 | Complex element | ARI uygulamasında bu, bir mesajın kök öğesidir Tek bir tesis için oda türlerini ve paketleri tanımlama. |
Transaction / @timestamp | 1 | DateTime | Bu mesajın oluşturulma tarihi ve saati. |
Transaction / @id | 1 | string | Bu istek mesajının benzersiz tanımlayıcısıdır. Bu değer döndürülür bu mesajdan yararlanabilirsiniz. İzin verilen karakterler a-z, A-Z, 0-9, _ şeklindedir (alt çizgi) ve - (kısa çizgi) tuşlarına basın. |
Transaction / @partner | 1 | string | Bu mesajın iş ortağı hesabıdır. Bu dize değeri
"İş ortağı anahtarı" değeri şurada listelenir:
Hotel Center'daki hesap ayarları sayfası.
Not: Aşağıdaki işlemler için feed sağlayan bir arka ucunuz varsa
birden fazla hesap varsa bu değerin |
Transaction / PropertyDataSet | 1.. | PropertyDataSet | Tek bir tesise ait oda türlerini ve paketleri tanımlayan kapsayıcıdır. |
Transaction / PropertyDataSet / @action | 0..1 | enum | Oda fiyatı tanımlarına uygulanacak güncelleme türüdür. Geçerli değerler şunlardır:
Bu özellik isteğe bağlıdır ve değilse varsayılan olarak |
Transaction / PropertyDataSet / Property | 1 | string | Tesisin benzersiz tanımlayıcısıdır. Bu değer,
Otel kimliği, kullanılarak belirtildi
<listing> öğesinde <id>
otel listesi feed'inde görünür. Otel Kimliği, Hotel Center'da da listelenir. |
Transaction / PropertyDataSet / RoomData | 0..n | RoomData | Bir odayı tanımlar. Not: En az bir |
Transaction / PropertyDataSet / RoomData / RoomID | 1 | RoomID | Bir oda türü için benzersiz tanımlayıcıdır. Bu değere,
InvTypeCode özelliğini
<StatusApplicationControl> öğesi
<OTA_HotelAvailNotifRQ> ve
<OTA_HotelRateAmountNotifRQ> mesaj. |
Transaction / PropertyDataSet / RoomData / Name | 1 | Name | Bir veya daha fazla odadaki oda kategorisi adının kapsayıcısıdır dil. |
Transaction / PropertyDataSet / RoomData / Name / Text | 1..n | Text | Bir dilde oda kategorisi adını belirtir. |
Transaction / PropertyDataSet / RoomData / Name / Text / @text | 1..n | string | Oda kategorisinin,
language özelliği için de kullanılmaktadır. |
Transaction / PropertyDataSet / RoomData / Description | 1 | Name | Bir veya daha fazla odadaki oda kategorisi açıklamasının kapsayıcısı dil. |
Transaction / PropertyDataSet / RoomData / Description / Text | 1..n | Text | Bir dilde oda kategorisi açıklamasını belirtir. |
Transaction / PropertyDataSet / RoomData / Description / Text / @text | 1..n | string | Oda kategorisinin belirtilen dildeki açıklaması
language özelliğine göre. |
Transaction / PropertyDataSet / RoomData / Description / Text / @language | 1..n | string | İki harfli dil kodu kullanabilirsiniz. |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs | 0..1 | AllowablePackageIDs | <AllowablePackageID> öğelerinin kapsayıcısıdır.
|
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID | 1..n | AllowablePackageID | Bu öğeyle birleştirilebilecek bir ücret planının PackageID'sini belirtir
oda türü. Ücret planı,
paket, fiyatlar ve stok durumu. PackageID
RatePlanCode değerine karşılık gelir
OTA_HotelRateAmountNotifRQ ve OTA_HotelAvailNotifRQ mesajları.
|
Transaction / PropertyDataSet / RoomData / Capacity | 0..1 | integer | Bir odada bulunabilecek maksimum yetişkin ve çocuk sayısı
fiziksel olarak uyum sağlaması gerekir. Bu değer, şundan büyük veya şuna eşit olmalıdır:
Ücretlerle birlikte gönderdiğiniz tüm NumberOfGuests değerleridir.
Not: |
Transaction / PropertyDataSet / RoomData / AdultCapacity | 0..1 | integer | Bir odada fiziksel olarak bulunabilecek maksimum yetişkin sayısı
uyum sağlamasıdır. Bu değer, minimum değerden büyük veya
Ücretlerle birlikte gönderdiğiniz NumberOfGuests değer.
|
Transaction / PropertyDataSet / RoomData / ChildCapacity | 0..1 | integer | Bir odanın fiziksel olarak yapabileceği maksimum çocuk sayısı
uyum sağlamasıdır.
|
Transaction / PropertyDataSet / RoomData / OccupancySettings | 0..1 | OccupancySettings | Bir reklamverenin doluluk gereksinimlerini kısıtlayabilen veya değiştirebilen ayarlar
oda.
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> Tüm alt öğelerin eklenmesi gerekmez. |
Transaction / PropertyDataSet / RoomData / PhotoURL | 0..n | PhotoURL | Belirtilen odanın veya ilgili odanın fotoğrafına ait URL ve isteğe bağlı başlık
Oda Paketi. Birden fazla <PhotoURL> belirtebilirsiniz
oda veya Oda Paketi için uygun.
Bu öğe aşağıdaki alt öğeleri alır:
<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> |
Oda özellikleriyle ilgili bilgileri içerir. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / JapaneseHotelRoomStyle | 0..1 | enum | Bir Japon otel odasının tarzını belirtir. Geçerli değerler şunlardır:
|
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds | 0..1 | Object | Odadaki kadar <Bed> bulunur. Not
Japon futonları burada sayılmaz.
Her
<Bed> aşağıdaki alt öğelere sahiptir:
<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 | Bu oda bir süitse bu öğeyi sağlayın. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Capsule | 0..1 | enum | Bu oda, kapsül oda olduğunda bu öğeyi sağlayın. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Roomsharing | 0..1 | enum | Bu odanın, tesis sahibi gibi diğer kişilerle paylaşılıp paylaşılmayacağı
veya diğer davetlileri kullanabilirsiniz. Geçerli değerler shared ve private değerleridir. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Outdoor | 0..1 | enum | Bu oda, şu özelliklere sahip olmayan bir açık hava konaklama tesisiyse bu öğeyi sağlayın: Sabit duvarlara, sıhhi tesisata ve klimaya sahip. Örneğin, otel odaları konukların çadırda kaldığı ve çadırda kaldığı kamp alanları Konukların kendi karavanlarıyla geldiği karavan parkları, açık hava konaklama yerleridir. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / MobileAccessible | 0..1 | enum | Bu oda, hareket kabiliyetine uygun olduğunda bu öğeyi sağlayın. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Smoking | 0..1 | enum | Bu odanın sigara içilmeyen oda mı yoksa sigara içilen oda mı olduğu bilgisi. Geçerli
değerleri non_smoking ve smoking şeklindedir. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet | 0..1 | Object | Odadaki banyo ve tuvalet hakkında bilgiler içerir.
Özellik:
Öğe isteğe bağlı olarak aşağıdaki alt öğeleri alır:
Örnek: <BathAndToilet relation="separate"> <Bath bathtub="1" shower="1"/> <Toilet electronic_bidet="1" mobility_accessible="1"/> </BathAndToilet> |
Transaction / PropertyDataSet / RoomData / RoomFeatures / OpenAirBath | 0..1 | enum | Bu odada özel açık hava banyosu varsa bu öğeyi sağlayın. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / AirConditioning | 0..1 | enum | Bu odada klima varsa bu öğeyi sağlayın. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Balcony | 0..1 | enum | Bu odada balkon veya veranda varsa bu öğeyi sağlayın. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Views | 0..1 | Object | Geçerli seçenekler şunlardır:
|
Transaction / PropertyDataSet / PackageData | 0..n | PackageData | Ücret özelliklerini ve şu özelliklere sahip terimleri açıklayan öğelerin kapsayıcısı: fiziksel oda açıklamasının bir parçası değildir. Not: En az bir |
Transaction / PropertyDataSet / PackageData / PackageID | 1 | string | Bu mesajlardaki PackageID değerine karşılık gelir
OTA_HotelRateAmountNotifRQ içinde RatePlanCode ve
OTA_HotelAvailNotifRQ mesajları. |
Transaction / PropertyDataSet / PackageData / Name | 1 | Name | Bir veya daha fazla dilde paket adının kapsayıcısıdır. |
Transaction / PropertyDataSet / PackageData / Name / Text | 1..n | Text | Paketin adını bir dilde belirtir. |
Transaction / PropertyDataSet / PackageData / Name / Text / @text | 1..n | string | Paketin,
language özelliği için de kullanılmaktadır. |
Transaction / PropertyDataSet / PackageData / Description | 1 | Description | Bir veya daha fazla dilde paketin açıklamasının kapsayıcısıdır. |
Transaction / PropertyDataSet / PackageData / Description / Text | 1..n | Text | Paketin açıklamasını bir dilde belirtir. |
Transaction / PropertyDataSet / PackageData / Description / Text / @text | 1..n | string | Paketin,
language özelliği için de kullanılmaktadır. |
Transaction / PropertyDataSet / PackageData / Description / Text / @language | 1..n | string | İki harfli dil kodu kullanabilirsiniz. |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs | 0..1 | AllowableRoomIDs | <AllowableRoomID> öğelerinin kapsayıcısıdır.
|
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID | 1..n | AllowableRoomID | Bununla birleştirilebilecek bir oda türünün RoomID'sini belirtir
ücret planı. Oda türü <RoomData> içinde tanımlanır.
öğesine dokunun.
|
Transaction / PropertyDataSet / PackageData / Refundable | 0..1 | Refundable | Bir ücretin tamamen geri ödenebilir veya iptal edilebilir olarak listelenmesini sağlar. Sağlanmazsa geri ödemeyle ilgili hiçbir bilgi gösterilmez.
Not: Tüm özellikleri ayarlamanızı öneririz. Feed bir veya daha fazla özellik eklendiğinde durum uyarı mesajı oluşturulur ayarlanmadı. Hiçbir özelliği ayarlamazsanız ücret geri ödeme yapılabilir. Özellikleri ayarlarken aşağıdakilere dikkat edin:
|
Transaction / PropertyDataSet / PackageData / Refundable / @available | 1 | boolean | (Zorunlu) 1 olarak ayarlayın veya
Fiyatın tam değere izin verip vermediğini belirtmek için true
geri ödeme; aksi takdirde 0 veya false olarak ayarlanır. |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days | 0..1 | integer | (Aşağıdaki durumlarda gereklidir:
available : true ) Belirtir
Eksiksiz geri ödeme alınabileceği gün sayısı check-in işleminden önce
istendi. refundable_until_days değeri
0 ile 330 arasında (0 ve 330 dahil) bir tam sayı olmalıdır. |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_time | 0.. | Time | (Aşağıdaki durumlarda özellikle
available : true ) Belirtir
günün en son saatine, otelin yerel saatine göre,
geri ödeme isteği dikkate alınır. Bu,
Belirtmek için refundable_until_days ,
Örneğin, "geri ödemeler iki gün önce saat 16:00'a kadar yapılabilir.
check-in" yazın. refundable_until_time ayarlanmazsa
varsayılan olarak gece yarısına ayarlanır. |
Transaction / PropertyDataSet / PackageData / BreakfastIncluded | 0..1 | boolean | Bu oda türünde kahvaltının dahil olup olmadığını belirtir.
Geçerli değerler 0 (veya false ) ve 1 'dir
(veya true ).
|
Transaction / PropertyDataSet / PackageData / CheckinTime | 0..1 | Time | Otelin yerel saatine göre mümkün olan en erken giriş saati. Saat 24:00'ten az olmalıdır. |
Transaction / PropertyDataSet / PackageData / CheckoutTime | 0..1 | Time | Otelin yerel saatine göre mümkün olan en geç çıkış saati. |
Transaction / PropertyDataSet / PackageData / InternetIncluded | 0..1 | boolean | Odada ücretsiz internet erişimi olup olmadığını belirtir
diğer odalarda bu imkan yoktur. Bu öğeyi
Tüm odalarda ücretsiz internet imkanı sunan otel. Bu öğe
oda içi kablolu internet veya şurada bulunan kablosuz internet için geçerli değildir:
oda seçeneği yoktur. Geçerli değerler 0 (veya
false ) ve 1 (veya true ).
|
Transaction / PropertyDataSet / PackageData / Meals | 0..1 | Object | Bu paketteki yemeklerle ilgili bilgiler içerir.
İsteğe bağlı özellikler yalnızca Yemek filtreleri için ( |
Transaction / PropertyDataSet / PackageData / ParkingIncluded | 0..1 | boolean | Odaya ücretsiz otopark dahil olup olmadığı,
Aksi takdirde bu otelde otopark ücretlidir. Belirtme
ücretsiz otopark sunan bir otelde bu öğe için bir değer.
Geçerli değerler 0 (veya false ) ve
1 (veya true ). Varsayılan değer:
false .
|
Transaction / PropertyDataSet / PackageData / PhotoURL | 0..1 | Object | (<RoomData> içindeki <PhotoURL> ile aynı,
ancak paket için (ör. yemek fotoğrafları) bakın.
|
Örnekler
Oda ve paket verileri
Aşağıda, tesisin odasının ve odanın nasıl tanımlanacağını gösteren
Transaction (Tesis Verileri) mesajındaki verileri paketleyecektir. overlay
özelliği, beklenmedik şekilde herhangi bir verinin mevcut olması durumunda
Tüm mevcut veriler silinir ve bu mesajdaki verilerle değiştirilir:
<?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>
Oda türü ekleyin
Aşağıda oda türü ve paketin nasıl ekleneceğine dair bir örnek verilmiştir:
mevcut <Transaction>
verileri:
<?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>
Oda türlerini kaldır
Aşağıda, mevcut oda türlerini kaldırma ve
paketlerini ekleyebilirsiniz. Bu senaryoda, "Oda ve paket verileri"ndeki mesajlar
ve "Oda türü ekle"yi seçin. daha önce Google'a gönderilmişse, King
ve
Google, mesajı aldıktan sonra Double
oda türü artık mevcut olmayacak
gösteriliyor. Paket verilerinin kaldırılması, genel ücret planını etkiler.
Transaction (Tesis Verileri), OTA_HotelRateAmountNotifRQ,
ve OTA_HotelAvailNotifRQ
mesaj (aynı PackageID
öğesine başvuruda bulunarak)
değeri), dolayısıyla diğer mesaj türlerini kullanan ilgili güncellemeler
PackageID_2
ve PackageID_3
öğelerinin artık geçerli olmadığını yansıtmak için
tanımlanmalıdır.
<?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>
Ücret planlarını kısıtlama
Aşağıda, <AllowablePackageIDs>
özelliğinin nasıl kullanılacağına dair bir örnek verilmiştir.
öğesini tıklayın. Bu örnekte
Queen
oda türü (RoomID_2
) yalnızca paket ve
ücret planı PackageID_1 olarak tanımlanmıştır.
<?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>
Oda kapasitesini kısıtla
Aşağıda <Capacity>
, <AdultCapacity>
,
Oda kapasiteleriyle ilgili kısıtlamalar ayarlamak için <ChildCapacity>
öğesi.
<?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>
Çift kişilik oda türünde (RoomID_1) toplamda en fazla 4 konuk olabilir. Ayrıca, Etkinlikte en fazla 4 yetişkin ve 3 çocuk yer alabilir. Üç kapasite bu odanın rezervasyon yapılabilir olması için koşulların karşılanması gerekir. Bu her biri iki yatak odasına sahip tipik bir odayı sığmasını sağlar. Alt çocuk kapasitesi, toplam kapasiteden bir az azdır. çünkü odada en az bir yetişkin bulunmalıdır.
<RoomFeatures>
ve yemekler için genişletilmiş örnekler
JapaneseHotelRoomStyle
öğesinin varsayılan değeri yok.
Bir değerin atlanması XML hatasına neden olmaz, ancak girişiniz
kullanıcı oda stiline veya yataklara göre filtrelendiğinde gösterilen arama sonuçlarında gösterilir.
İki adet tek kişilik yatak
Aşağıdaki örnekte <RoomFeatures>
hizmetinin nasıl kullanılacağı gösterilmektedir:
<?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>
İki adet çift kişilik yatak
Aşağıda iki kişilik western
tarzı oda örneği verilmiştir.
double
yatak.
<?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>
Yataksız Japon tarzı
Aşağıda yataksız Japon tarzı bir oda örneği verilmiştir. Yatak
japanese
stili oda için bilgi gerekmiyor.
<?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>
Yataklı kovboy Japon tarzı
Aşağıda king
bulunan japanese_western
tarzı bir oda örneği verilmiştir.
yatak.
<?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>
İş ortağı, japanese_western
içindeki yatak sayısı hakkında bilgiye sahip değilse
oda varsa aşağıdaki örneğe bakın:
<?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>
Yemekler
Aşağıdaki örnekte yemekler, fotoğraflar ve öğeler için oda ve paket meta verileri tanımlanmaktadır. ve check-in ile çıkış saatlerini öğrenin:
<?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>
Yalnızca kahvaltı
<?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>
Yanıtlar
Söz dizimi
TransactionResponse (Property Data)
mesajında aşağıdaki söz dizimi kullanılır:
<?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>
Öğeler ve özellikler
TransactionResponse (Property Data)
mesajında şunlar var:
öğeler ve özellikler:
Öğe / @Özellik | Yineleme sayısı | Tür | Açıklama |
---|---|---|---|
TransactionResponse | 1 | Complex element | Alınan bir öğenin başarısını veya sorunlarını gösteren kök öğe İşlem istek mesajı. |
TransactionResponse / @timestamp | 1 | DateTime | Bu mesajın oluşturulma tarihi ve saati. |
TransactionResponse / @id | 1 | string | İlişkilendirilmiş Transaction mesajındaki benzersiz tanımlayıcıdır. |
TransactionResponse / @partner | 1 | string | Bu mesajın iş ortağı hesabıdır. |
TransactionResponse / Success | 0..1 | Success | Transaction mesajının başarıyla işlendiğini belirtir
uyarı, hata veya sorun yok.
|
TransactionResponse / Issues | 0..1 | Issues | işlenirken karşılaşılan bir veya daha fazla sorun için bir kapsayıcı
İşlem mesajı.
|
TransactionResponse / Issues / Issue | 1..n | Issue | Güncelleme sırasında karşılaşılan uyarı, hata veya sorunun Transaction mesajının işlenmesiyle ilgilidir. Bu sorunlarla ilgili ayrıntılar şurada bulunabilir: Feed Durumu Hata Mesajları başlıklı bölüme bakın. |
TransactionResponse / Issues / Issue / @code | 1 | integer | Sorunun tanımlayıcısıdır. |
TransactionResponse / Issues / Issue / @status | 1 | enum | Karşılaşılan sorunun türü. Geçerli değerler |
Örnekler
Başarılı
Aşağıda, başarıyla işlenmiş bir Transaction mesajına yanıt yer almaktadır.
<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<Success/>
</TransactionResponse>
Sorunlar
Aşağıda, hatalar.
<?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>