トランザクション(宿泊施設データ)

リクエスト

構文

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 検索にフィードを提供するバックエンドがある場合、 複数のアカウントがある場合は、この値は ID と一致する必要があります <RequestorID> で指定された属性値 <OTA_HotelRateAmountNotifRQ> の要素と 同じアカウントに <OTA_HotelAvailNotifRQ> 件のメッセージが届いています。

Transaction / PropertyDataSet 1.. PropertyDataSet 1 つの宿泊施設に対応する客室タイプとパッケージを定義するためのコンテナ。
Transaction / PropertyDataSet / @action 0..1 enum

客室料金の定義に適用する更新のタイプ。

指定できる値は次のとおりです。

  • overlay :: 以前に定義したものをすべて置き換えます。 <RoomData> さんと <PackageData> さん 指定します。<RoomData> と 現在のメッセージの <PackageData> は有効です。
  • delta : 以前に未定義の要素を追加します <RoomData> さんと <PackageData> さん 既存のルールを修正できます

この属性は省略可能です。指定しない場合のデフォルトは delta です。 あります。

Transaction / PropertyDataSet / Property 1 string 宿泊施設の一意の識別子。この値は、 を使用して指定したホテル ID <listing> 要素内の <id> ホテルリスト フィードで表示できます。ホテル ID は Hotel Center にも表示されます。
Transaction / PropertyDataSet / RoomData 0..n RoomData

客室の説明です。

注: <RoomData> の少なくとも 1 つ または <PackageData> は必須です。

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> 要素のコンテナ。

<AllowablePackageIDs> を指定した場合、客室 <RoomID> によって識別されるタイプ 親 <RoomData> 要素には、 定義された料金プランと組み合わせ <AllowablePackageID> 要素。

<AllowablePackageIDs> が指定されていない場合、会議室は 親の <RoomID> によって識別される型 <RoomData> 要素は任意の 考えてみましょう

<AllowablePackageIDs> または <AllowableRoomIDs> で、両方は不可。

Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID 1..n AllowablePackageID これと組み合わせることができる料金プランの PackageID を指定します。 。料金プランは、次の組み合わせによって定義されます。 パッケージ、料金、空室状況を確認できますPackageID 対応する RatePlanCode OTA_HotelRateAmountNotifRQ メッセージと OTA_HotelAvailNotifRQ メッセージ。
Transaction / PropertyDataSet / RoomData / Capacity 0..1 integer 1 つの部屋で利用できる大人と子どもの最大数 物理的に対応します。次の値以上を指定してください 料金と一緒に送信する NumberOfGuests 値。

<Capacity> の値には正の整数を指定してください 199 の範囲内(両端を含む)。詳しくは、 こちらの例をご覧ください。

注: <Capacity> が設定されていない場合、数値は 何人までが入居無制限と見なされます。このフィールドが に設定されておらず、ExtraGuestCharges または AdditionalGuestAmounts が定義されており、価格が 任意の数の居住者に対して生成できます。おすすめの方法 ExtraGuestCharges の場合は <Capacity> を設定する または AdditionalGuestAmounts を定義して、 無効な宿泊人数オプションに対しては表示されません。

Transaction / PropertyDataSet / RoomData / AdultCapacity 0..1 integer 客室が物理的に確保できる大人の最大人数 対応。いずれかの値以上を指定してください 料金と一緒に送信する NumberOfGuests 値。

<AdultCapacity> の値は正の数で指定してください 199 の整数(両端を含む)。詳しくは、 こちらの例をご覧ください。

Transaction / PropertyDataSet / RoomData / ChildCapacity 0..1 integer 1 つの部屋が物理的に確保できる子どもの最大数 対応

<ChildCapacity> の値は正の数で指定してください 1 ~ 99 の整数。詳しくは、 こちらの例をご覧ください。

Transaction / PropertyDataSet / RoomData / OccupancySettings 0..1 OccupancySettings 特定の宿泊人数に関する要件を制限または変更できる設定です。 できます。

<OccupancySettings> 要素は 次の子要素:

  • <MinOccupancy>: 宿泊客の最小数 確保できます。たとえば、このルールを 2、この会議室を 1 名で予約することはできません。

    <MinOccupancy> の値は正の数で指定してください 1 ~ 99 の整数。

  • <MinAge>: 同伴者全員の最低年齢 可能性があります。たとえば、18 に設定した場合、 この会議室は、ゲスト全員が 18 歳以上のグループ用にのみ予約できます 以上です。

    <MinAge> の値には正の整数を指定してください 0 ~ 99 の範囲内。

<OccupancySettings>
  <MinOccupancy>2</MinOccupancy>
  <MinAge>16</MinAge>
</OccupancySettings>

すべての子要素を含める必要はありません。

Transaction / PropertyDataSet / RoomData / PhotoURL 0..n PhotoURL 指定された部屋の写真の URL と説明(省略可) 条件の組み合わせ。複数の <PhotoURL> を指定できます。 自動的に適用されます

この要素では、次の子要素を使用します。

  • <URL>: 写真の場所を指定します。「 ファイアウォールの内側ではなく、一般公開されている プロトコル(http://)。
  • <Caption>: 写真の説明を定義します。 この要素は、単一の子要素 <Text> を使用します。 これには TextlanguageText 属性はキャプションです。 language 属性では 2 文字の 言語コード(en など)を使用します。
<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

日本のホテルの客室のスタイルを示します。

指定できる値は次のとおりです。

  • western: ベッドを備えた洋室。
  • japanese: 布団を備えた和室。
  • japanese_western: 以下を備えた和洋室 ベッドを備えた和洋室の客室を用意している。
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds 0..1 Object チャットルームと同じ数の <Bed> が含まれます。注 日本の布団はカウントされません。

<Bed> には次の属性があります。

  • size(省略可): 有効な値は single です。 semi_doubledoublequeenking
で確認できます。 各 <Bed> には次の子要素があります。 <ph type="x-smartling-placeholder">
    </ph>
  • <Width>(省略可): ベッドの幅を指定します。 属性 unit の値は cm にする必要があります。 属性 number は、ベッドの幅(整数センチメートル)に置き換えます。
  • <Length>(省略可): ベッドの長さを指定します。 属性 unit の値は cm にする必要があります。 属性 number には、ベッドの長さを指定します。 使用します。
で確認できます。 例:
<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 この部屋をオーナーなど、他の居住者と共有するかどうか できます。有効な値は sharedprivate です。
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_smokingsmoking です。
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet 0..1 Object 客室のバスルームとトイレに関する情報が含まれています。

属性は次のとおりです。

  • relation(省略可): 浴室と トイレは互いに相対的に配置されています。有効な値は次のとおりです。 together: たとえば、浴室と浴室が 2 台になっている浴室 トイレが同じ部屋にあるおよび separate、浴室とトイレにそれぞれ専用の できます。会議室に予約がない場合、この属性を設定することはできません 浴室とトイレを揃えています

この要素は、必要に応じて次の子要素を使用します。

  • <Bath>(省略可): この要素の存在 は、部屋に浴室があることを示します。

    属性は次のとおりです。

    • bathtub(省略可): 浴室に 浴室にバスタブがあるわけです有効な値は 0 です。 (または false)、1(または true)。
    • shower(省略可): 浴室に シャワーを浴びることもできます。有効な値は 0(または false)と 1(または true)。
  • <Toilet>(省略可): この要素の存在 は、この部屋にトイレがあることを示します。

    属性は次のとおりです。

    • electronic_bidet(省略可): トイレに電子ビデあり。 有効な値は 0(または false)と 1(または true)。
    • mobility_accessible(省略可): トイレはバリアフリーです。有効な値は 0 です。 (または false)、1(または true)。

例:

<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 有効なオプションは次のとおりです。

<AirportView/>
<BayView/>
<BeachView>/>
<CastleView/>
<CityView/>
<CountrysideView/>
<CourtyardView/>
<DuneView/>
<ForestView/>
<GardenView/>
<GolfCourseView/>
<HarborView/>
<LagoonView/>
<LakeView/>
<MarinaView/>
<MountainView/>
<NatureView/>
<OceanView/>
<ParkView/>
<PartialOceanView/>
<PisteView/>
<PoolView/>
<PyramidView/>
<RiverView/>
<StreetView/>

Transaction / PropertyDataSet / PackageData 0..n PackageData

料金機能や条件を記述する要素のコンテナ。 会議室の説明には含まれていません。

注: <RoomData> の少なくとも 1 つ または <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> 要素のコンテナ。

<AllowableRoomIDs> が指定されている場合、料金プラン <PackageID> によって識別される 親 <PackageData> 要素には、 定義した客室タイプと <AllowableRoomID> 要素。

<AllowableRoomIDs> が指定されていない場合、レート 親の <PackageID> によって識別されるプラン <PackageData> 要素は任意の 。

<AllowablePackageIDs> または <AllowableRoomIDs> で、両方は不可。

Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID 1..n AllowableRoomID これと組み合わせることができる客室タイプの RoomID を指定します 考えてみましょう客室タイプは <RoomData> で定義されます。 要素です。
Transaction / PropertyDataSet / PackageData / Refundable 0..1 Refundable 全額払い戻しまたはキャンセル可能として料金を掲載できるようにします。指定しない場合、払い戻しに関する情報は表示されません。

注: すべての属性を設定することをおすすめします。フィード ステータスに関する警告メッセージが、1 つ以上の属性が 未設定。

属性を設定しない場合、レートは 払い戻しが可能です。

属性を設定する際は、次の点に注意してください。

  • available または refundable_until_days の場合 設定されていない場合、料金は払い戻し可能として表示されません。
  • available0 または false の場合、 他の属性は無視されます。レートは次のように表示されません。 他の属性の一方または両方が設定されていても、refundable になります。
Transaction / PropertyDataSet / PackageData / Refundable / @available 1 boolean (必須)1 または true は、料金で完全な許容可能かどうかを示します。 refundそれ以外の場合は 0 または false に設定します。
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days 0..1 integer availabletrue の場合) 全額払い戻しを受けられるチェックインまでの日数 渡されます。refundable_until_days の値 0 ~ 330 の整数にする必要があります。
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_time 0.. Time (Google Chat で availabletrue の場合) ホテルの現地時間で示されます 払い戻しのリクエストは可能です。これを組み合わせ可能 refundable_until_days: 指定する たとえば、「払い戻しは 2 日前の午後 4 時まで可能です」 チェックインします。refundable_until_time が設定されていない場合、この値 デフォルトは午前 0 時です
Transaction / PropertyDataSet / PackageData / BreakfastIncluded 0..1 boolean この客室タイプに朝食が含まれるかどうかを指定します。 有効な値は 0(または false)と 1 です。 (または true)。

<Meals> を使用することをおすすめします。 <BreakfastIncluded> の代わりに表示されます。

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 このパッケージ内の食事に関する情報が含まれています。

<Meals> 要素は、2 つの省略可能な子要素を取ります。 要素、<Breakfast><Dinner>、 次の属性を持ちます。

  • included(必須): 1(または true0 または false に設定。
  • in_room(省略可): 1(または true)または宿泊客が朝食と夕食を選べる 客室での作業に追われているそれ以外の場合は 0(または false)。
  • in_private_space(省略可): 1 に設定します。 (または true): 宿泊客が朝食を食べることもできる場合。 避けることができる場所(宿泊先を除く)での夕食 他の同伴者との接触それ以外の場合は 0(または false)。
  • buffet(省略可): 1(または true)の朝食または夕食をビュッフェ形式で提供する場合。 それ以外の場合は 0(または false)に設定します。

オプションの属性は、included が次の場合にのみ使用されます。 あります。

食事フィルタ(no mealsbreakfast onlydinner onlybreakfast and dinner)が職場まで到着すると、 <Breakfast><Dinner> は両方とも included 属性で指定する必要があります。

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_2PackageID_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>
<ph type="x-smartling-placeholder">
</ph>

朝食のみ

<?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 トランザクション メッセージが正常に処理されたことを示します 警告、エラー、失敗が発生することがありません。

<Success> または <Issues> が 表示されます。

TransactionResponse / Issues 0..1 Issues データの処理中に発生した 1 つ以上の問題のコンテナです。 トランザクション メッセージ。

<Success> または <Issues> が 表示されます。

TransactionResponse / Issues / Issue 1..n Issue この間に発生した警告、エラー、失敗の説明は、 トランザクション メッセージを処理しています。これらの問題の詳細については、 フィード ステータスのエラー メッセージをご覧ください。
TransactionResponse / Issues / Issue / @code 1 integer 問題の識別子。
TransactionResponse / Issues / Issue / @status 1 enum

発生した問題の種類。

有効な値は warningerror、 および failure

成功

以下は、正常に処理された 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>