このページは Cloud Translation API によって翻訳されました。

トランザクション（宿泊施設データ）メッセージ

概要

ARI Transaction（宿泊施設データ）メッセージは、各物件の情報と宿泊施設の客室タイプとパッケージ（または料金プラン）です。各客室タイプのデータには、一意の識別子（RoomID）、ローカライズされた名前、説明、客室写真の URL が含まれます。各パッケージデータには、一意の識別子（PackageID）、ローカライズされた名前、説明、宿泊人数、付加価値が含まれます。

トランザクションメッセージを使用すると、次のことができます。

1 つ以上のプロパティのデータを定義します。
各宿泊施設の客室タイプとパッケージの情報を定義します。
商品を管理します。

また、次のようなアクションを設定することもできます。

客室タイプとパッケージをプロパティに追加します。

重要ポイント: 客室タイプには、宿泊施設ごとに最大 3,000 個の上限があります。パッケージにはプロパティごとに最大 3,000 個です。<Transaction> のメッセージを使用すると、次のことができます。客室タイプやパッケージを削除してください。
客室タイプとパッケージをプロパティから削除します。

トランザクションメッセージの例については、Transaction（宿泊施設データ）例。

必須要素と省略可能な要素

XML リファレンスでは、必須要素と省略可能な要素について説明します。詳細については、属性と子要素については、トランザクション（宿泊施設データ）要素と属性をご覧ください。

構文とスキーマ

Transaction（宿泊施設データ）構文トランザクションメッセージを作成する際に参考として使用できる例を正しい形式に従っていることを確認します

サードパーティ XML ツール（xmllint など）を使用して、 Google に送信する前に、公開スキーマを更新する。トランザクションメッセージスキーマの詳細については、ホテル広告説明します。

ガイドライン

トランザクションメッセージについては、次のガイドラインを使用してください。

達成方法:: delta: 新しい客室タイプとパッケージ（料金プラン）を追加または更新するために使用します。; overlay: プロパティのすべての客室タイプとパッケージを作成します。対象となるすべての客室タイプと料金プランに関する情報を含める必要があります。選択する必要があります
言語のサポート:: 1 つか 2 つの言語（英語と、宿泊施設の現地の言語）を指定するを [Name]、[Description]、[Caption] に入力します。さらに追加できます 2 言語以上で構成する必要があります。
客室タイプとパッケージ:: 客室タイプまたはパッケージを更新する場合は、関連するすべてのその客室タイプやパッケージの情報が表示されますたとえば、スペースに名前と説明も含める必要があります。; <AllowablePackageIDs> と <AllowableRoomIDs> は省略可能です。設定しない場合は、次のようになります。客室タイプと料金プランの任意の組み合わせが可能です。客室タイプ ID と料金プラン ID を指定して空室状況と料金を送信する必要があります。これらの要素を使用すると、プロダクトを制御したり、システムでサポートされていない組み合わせを無効にしたりできます。; 会議室に変更があったときは、Google にトランザクションメッセージの更新情報を送信客室のタイプやパッケージに関する重要な情報、追加する必要があります。

例

このセクションでは、ARI トランザクションメッセージの基本的な例を示します。必須の要素と省略可能な要素です。客室タイプとパッケージを追加または更新するには、delta のアクションを使用して客室タイプとパッケージを追加または更新するか、overlay のアクションを使用してすべての客室タイプとパッケージの定義を置き換えます（古いエントリは削除されます）。

1 つか 2 つの言語（英語と、その地域固有の言語）を指定する必要があります。プロパティ（必要に応じて）を [Name]、[Description]、[Caption] フィールドに入力します。次に、写真へのリンクを含む宿泊施設データ情報。

<PropertyID> と <RoomID> には、システム内で料金プランと客室タイプに使用している ID をそれぞれ使用します。Google で料金とデータを正しく表示するには、貴社のシステムとの整合性が重要です。

ファイルを準備したら、POST メッセージで Google に送信する必要がありますエンドポイント https://www.google.com/travel/hotels/uploads/property_data へ

メッセージを push または POST する方法については、メッセージの push をご覧ください。

次の例は、delta を使用してトランザクションメッセージを設定する方法を示しています。アクション:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

overlay アクションの使用方法など、その他の例については、部屋のタイプを追加してください。既存の宿泊施設データへのパッケージ化、既存の客室タイプとパッケージについては、Transaction（宿泊施設データ）例。

入門ガイド

このセクションでは、Google Workspace の使用中に発生する可能性のあるシナリオのトランザクションメッセージを送信します。

シナリオ 1: 客室タイプのデータを削除する方法

既存の客室タイプやパッケージデータを削除するにはどうすればよいですか？

説明

お客様のために、キングルームとクイーンルームなど、複数の客室タイプをお送りいただきました。プロパティです。全タイプのクイーンルームは改装時に利用不可で、キングのみ利用可能な客室タイプがあります。

解決策

次の日付の 1 泊の空室状況、料金、在庫を更新する必要はありません。削除または無効化された客室タイプとパッケージ ID。
客室タイプまたはパッケージが削除または無効化された場合は、新しいチャットルームのみを含む action="overlay" さんとのトランザクションメッセージまだ有効であり、削除された客室タイプを除外したタイプとパッケージありません。

サンプル

次の XML スニペットは、overlay アクションを使用して客室タイプを削除する方法を示しています。

キングとクイーンの部屋タイプを含む元の delta アクションは次のとおりです。

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</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>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

次に、overlay を設定してクイーンルームのタイプを削除し、キングを維持できます部屋のタイプ:

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</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>
  </PropertyDataSet>

シナリオ 2: AllowablePackageID を使用して商品を制御する方法

パッケージが客室タイプ別にグループ化されている場合、商品（客室タイプとパッケージの組み合わせ）を管理するにはどうすればよいですか？

説明

特定の客室タイプでのみ利用できるパッケージもあります。対象たとえば、宿泊施設に 4 つの客室タイプ（プレジデンシャルスイートを含む）がある場合、 6 種類ありますが、1 ～ 6 種類のパッケージしか表示する場合は利用資格を指定できます

解決策

どの商品が含まれるかを指定した、更新したトランザクションメッセージを送信します <AllowablePackageIDs> を使用してパッケージ内に存在。

サンプル

この XML スニペットは、<AllowablePackageIDs> を使用してパッケージを指定する方法を示しています。使用することもできます。ペントハウススイートのペントハウスのオールインクルーシブパッケージまたは無料の朝食パッケージをスイートのキングサイズルームタイプは、キングオールインクルーシブパッケージ、またはペットにも優しいパッケージ。

<RoomData>
  <RoomID>penthouse_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
    <AllowablePackageID>free_breakfast</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
  <RoomID>king_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>king_all_inclusive</AllowablePackageID>
    <AllowablePackageID>pet_friendly</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
  <PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>pet_friendly</PackageID>
</PackageData>

シナリオ 3: AllowableRoomID を使用して製品を制御する方法

客室タイプがパッケージ別にグループ化されている場合、商品（客室タイプとパッケージの組み合わせ）を管理するにはどうすればよいですか？

説明

客室タイプとパッケージの組み合わせが商品として販売されなくなった、または新しいパッケージに何を含めるかを制御できます。たとえばキングルームやクイーンルームなど、オーシャンビューの特定の客室タイプのみ。提供します。

解決策

対象の商品を正確に指定した、更新したトランザクションメッセージを送信します <AllowableRoomIDs> 要素を使用してパッケージと関連付けます。

サンプル

<AllowableRoomID> を使用してオーシャンビュー King を指定する XML スニペットパッケージに含まれるクイーンの部屋タイプです。

<PackageID>RO</PackageID>
<AllowableRoomIDs>
  <AllowableRoomID>king_oceanview</AllowableRoomID>
  <AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>

トランザクション（宿泊施設データ）メッセージ

概要

必須要素と省略可能な要素

構文とスキーマ

ガイドライン

例

入門ガイド

シナリオ 1: 客室タイプのデータを削除する方法

既存の客室タイプやパッケージ データを削除するにはどうすればよいですか？

説明

解決策

サンプル

シナリオ 2: AllowablePackageID を使用して商品を制御する方法

パッケージが客室タイプ別にグループ化されている場合、商品（客室タイプとパッケージの組み合わせ）を管理するにはどうすればよいですか？

説明

解決策

サンプル

シナリオ 3: AllowableRoomID を使用して製品を制御する方法

客室タイプがパッケージ別にグループ化されている場合、商品（客室タイプとパッケージの組み合わせ）を管理するにはどうすればよいですか？

説明

解決策

サンプル

既存の客室タイプやパッケージデータを削除するにはどうすればよいですか？