リクエスト
構文
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>
要素と属性
Transaction(宿泊施設データ)メッセージには以下の要素が含まれます。 属性:
要素 / @Attribute | 発生回数 | タイプ | 説明 |
---|---|---|---|
Transaction | 1 | Complex element | ARI の実装では、これはメッセージのルート要素です。 単一宿泊施設の客室タイプとパッケージを定義します。 |
Transaction / @timestamp | 1 | DateTime | このメッセージの作成日時。 |
Transaction / @id | 1 | string | このリクエスト メッセージの一意の識別子。この値は レスポンス メッセージで識別されます。使用できる文字は、a ~ z、A ~ Z、0 ~ 9、_ です。 (アンダースコア)、-(ダッシュ)を使用できます。 |
Transaction / @partner | 1 | string | このメッセージのパートナー アカウント。この文字列値は、トレーニング データの
[パートナー キー]記載されている値
<ph type="x-smartling-placeholder"></ph>
Hotel Center の [アカウント設定] ページ。
注: Google 検索にフィードを提供するバックエンドがある場合、
複数のアカウントがある場合は、この値は |
Transaction / PropertyDataSet | 1.. | PropertyDataSet | 1 つの宿泊施設に対応する客室タイプとパッケージを定義するためのコンテナ。 |
Transaction / PropertyDataSet / @action | 0..1 | enum | 客室料金の定義に適用する更新のタイプ。 指定できる値は次のとおりです。
この属性は省略可能です。指定しない場合のデフォルトは |
Transaction / PropertyDataSet / Property | 1 | string | 宿泊施設の一意の識別子。この値は、
を使用して指定したホテル ID
<listing> 要素内の <id>
ホテルリスト フィードで表示できます。ホテル ID は Hotel Center にも表示されます。 |
Transaction / PropertyDataSet / RoomData | 0..n | RoomData | 客室の説明です。 注: |
Transaction / PropertyDataSet / RoomData / RoomID | 1 | RoomID | 客室タイプの一意の識別子。この値は、
InvTypeCode 属性を
<StatusApplicationControl> 要素
<OTA_HotelAvailNotifRQ> と
<OTA_HotelRateAmountNotifRQ> 件のメッセージ。 |
Transaction / PropertyDataSet / RoomData / Name | 1 | Name | 1 つ以上の客室のカテゴリの名前のコンテナ 対応しています。 |
Transaction / PropertyDataSet / RoomData / Name / Text | 1..n | Text | 客室のカテゴリ名を 1 つの言語で指定します。 |
Transaction / PropertyDataSet / RoomData / Name / Text / @text | 1..n | string | で指定された言語での客室のカテゴリ名
language 属性。 |
Transaction / PropertyDataSet / RoomData / Description | 1 | Name | 1 つ以上の客室のカテゴリの説明を格納するコンテナ 対応しています。 |
Transaction / PropertyDataSet / RoomData / Description / Text | 1..n | Text | 客室のカテゴリの説明を 1 つの言語で指定します。 |
Transaction / PropertyDataSet / RoomData / Description / Text / @text | 1..n | string | 指定された言語での客室のカテゴリの説明
language 属性で指定できます。 |
Transaction / PropertyDataSet / RoomData / Description / Text / @language | 1..n | string | 2 文字の 言語コード。 |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs | 0..1 | AllowablePackageIDs | <AllowablePackageID> 要素のコンテナ。
|
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID | 1..n | AllowablePackageID | これと組み合わせることができる料金プランの PackageID を指定します。
。料金プランは、次の組み合わせによって定義されます。
パッケージ、料金、空室状況を確認できますPackageID
対応する RatePlanCode
OTA_HotelRateAmountNotifRQ メッセージと OTA_HotelAvailNotifRQ メッセージ。
|
Transaction / PropertyDataSet / RoomData / Capacity | 0..1 | integer | 1 つの部屋で利用できる大人と子どもの最大数
物理的に対応します。次の値以上を指定してください
料金と一緒に送信する NumberOfGuests 値。
注: |
Transaction / PropertyDataSet / RoomData / AdultCapacity | 0..1 | integer | 客室が物理的に確保できる大人の最大人数
対応。いずれかの値以上を指定してください
料金と一緒に送信する NumberOfGuests 値。
|
Transaction / PropertyDataSet / RoomData / ChildCapacity | 0..1 | integer | 1 つの部屋が物理的に確保できる子どもの最大数
対応。
|
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> には次の子要素があります。
<ph type="x-smartling-placeholder">
<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 | この部屋が屋外の宿泊施設である場合に、この要素を指定します。 固定壁、配管設備、クライメート コントロールがあります。例: ホテルの部屋 キャンプ場はアウトドア宿泊施設ではありませんが 宿泊客が自分の RV 車をレンタルできる RV パークは屋外の宿泊施設です。 |
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 の RatePlanCode 、
OTA_HotelAvailNotifRQ メッセージ。 |
Transaction / PropertyDataSet / PackageData / Name | 1 | Name | 1 つ以上の言語でのパッケージの名前のコンテナ。 |
Transaction / PropertyDataSet / PackageData / Name / Text | 1..n | Text | パッケージの名前を 1 つの言語で指定します。 |
Transaction / PropertyDataSet / PackageData / Name / Text / @text | 1..n | string |
language 属性。 |
Transaction / PropertyDataSet / PackageData / Description | 1 | Description | 1 つ以上の言語でのパッケージの説明のコンテナ。 |
Transaction / PropertyDataSet / PackageData / Description / Text | 1..n | Text | パッケージの説明を 1 つの言語で指定します。 |
Transaction / PropertyDataSet / PackageData / Description / Text / @text | 1..n | string |
language 属性。 |
Transaction / PropertyDataSet / PackageData / Description / Text / @language | 1..n | string | 2 文字の 言語コード。 |
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 | 全額払い戻しまたはキャンセル可能として料金を掲載できるようにします。指定しない場合、払い戻しに関する情報は表示されません。
注: すべての属性を設定することをおすすめします。フィード ステータスに関する警告メッセージが、1 つ以上の属性が 未設定。 属性を設定しない場合、レートは 払い戻しが可能です。 属性を設定する際は、次の点に注意してください。
|
Transaction / PropertyDataSet / PackageData / Refundable / @available | 1 | boolean | (必須)1 または
true は、料金で完全な許容可能かどうかを示します。
refund;それ以外の場合は 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 | (Google Chat で
available が true の場合)
ホテルの現地時間で示されます
払い戻しのリクエストは可能です。これを組み合わせ可能
refundable_until_days : 指定する
たとえば、「払い戻しは 2 日前の午後 4 時まで可能です」
チェックインします。refundable_until_time が設定されていない場合、この値
デフォルトは午前 0 時です |
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> と同じ、
パッケージ(食事の写真など)の場合。
|
例
客室とパッケージのデータ
以下に、宿泊施設の部屋と部屋を定義する方法の基本的な例を示します。
Transaction(宿泊施設データ)メッセージにデータをまとめます。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 に送信されたメール、King
、
Google がメッセージを受信すると、Double
の客室タイプは存在しなくなります
表示されます。パッケージ データを削除すると、料金プラン全体に影響しますのでご注意ください。
Transaction(宿泊施設データ)、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
)は、パッケージおよび
PackageID_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 人まで宿泊できます。3 つの容量すべて この会議室を予約可能にするには、要件を満たしている必要があります。この 2 台のベッドを備えた一般的な部屋を象徴するような構成になっています。 適したサイズです。子の容量が合計容量の 1 つ少ない というのも、同室には大人が 1 人以上いる必要があるためです。
<RoomFeatures>
と食事を含む拡張例
JapaneseHotelRoomStyle
にデフォルト値はありません。
値を省略しても XML エラーは発生しませんが、リスティングは除外されません。
。
シングルベッド 2 台
次の例は、<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>
ダブルベッド 2 台
以下は、2 つの部屋がある western
スタイルの部屋の例です。
ベッド double
台。
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
<Beds> <!-- Two double beds-->
<Bed size="double"></Bed>
<Bed size="double"></Bed>
</Beds>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
ベッドなしの和風
以下は、ベッドのない和室の例です。ベッド
japanese
スタイルの部屋の情報は必要ありません。
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese</JapaneseHotelRoomStyle>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
和洋室(ベッドあり)
king
のある japanese_western
スタイルの部屋の例です。
。
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
<Beds>
<Bed size="king"></Bed>
</Beds>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
パートナーがjapanese_western
のベッド数情報を保有していない場合
次の例を参照してください。
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
食事
次の例では、食事、写真、検索に関する客室とパッケージのメタデータを定義しています。 チェックイン時刻とチェックアウト時刻:
<?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 | 関連付けられた Transaction メッセージからの一意の識別子。 |
TransactionResponse / @partner | 1 | string | このメッセージのパートナー アカウント。 |
TransactionResponse / Success | 0..1 | Success | トランザクション メッセージが正常に処理されたことを示します
警告、エラー、失敗が発生することがありません。
|
TransactionResponse / Issues | 0..1 | Issues | データの処理中に発生した 1 つ以上の問題のコンテナです。
トランザクション メッセージ。
|
TransactionResponse / Issues / Issue | 1..n | Issue | この間に発生した警告、エラー、失敗の説明は、 トランザクション メッセージを処理します。これらの問題の詳細については、 フィード ステータスのエラー メッセージをご覧ください。 |
TransactionResponse / Issues / Issue / @code | 1 | integer | 問題の識別子。 |
TransactionResponse / Issues / Issue / @status | 1 | enum | 発生した問題の種類。 有効な値は |
例
成功
以下は、正常に処理された Transaction メッセージに対するレスポンスです。
<?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>