ARI の概要

空室状況、料金、在庫（ARI）は、1 泊あたりの料金、空室状況、在庫を制御し、それらの組み合わせ方法に制約を適用する料金配信モードです。また、税金、手数料、プロモーションを柔軟に含めることができます。

旅行プランに基づく料金の配信モード（プル型料金と変更済み料金）とは異なり、ARI フィードでは、特定の料金や旅行プランは照会されません。代わりに、料金の詳細や制限、空室状況の変更など、料金モデルの新しいデータまたは変更されたデータが利用可能になった時点で、メッセージを push します。

利点

ARI には次のような利点があります。

  • 帯域幅の効率性: 転送する必要があるデータ量を減らすことで、帯域幅の効率性を高めます。1 泊分の ARI データと増分変更のみを送信することで、Google は幅広い前払いおよび宿泊日数に対して料金と更新を計算できます。

  • 料金の精度: 変更時にプッシュするイベントモデルを使用してライブ更新を行うことで、料金の精度が向上します。

  • より広範な価格カバレッジ: さまざまな旅行プランに組み合わせた詳細なデータを使用して、より広範な価格カバレッジ（価格が設定された旅行プランの数）を実現します。

  • 柔軟性: プロモーションやパッケージの提供に柔軟性を持たせることができます。

  • 使いやすさ: システムに保存されている方法に合わせてデータを送信するため、多くの旅行プランの料金を計算したりキャッシュに保存したりする必要がありません。

リクエスト メッセージの種類

Google に送信される ARI メッセージは、ARI「要求」メッセージと呼ばれます。Google はその後、成功または失敗を示す「応答」メッセージを返します。

ARI は、空室状況と在庫を定義する主なメッセージ タイプで OpenTravel Alliance (OTA) の標準プロトコルに準拠しています。

ARI は次のリクエスト メッセージを使用します。

  • Transaction（宿泊施設データ）。客室タイプとパッケージ（料金プラン）の情報を定義します。

  • OTA_HotelRateAmountNotifRQ。特定の期間の商品（客室タイプと料金プランの組み合わせ）ごとの日別または LOS ベースの宿泊人数料金の金額を定義します。

  • OTA_HotelAvailNotifRQ。客室タイプと料金プランに基づいて空室状況と制限を定義します。このメッセージを使用して在庫を更新することもできますが、OTA_HotelInvCountNotifRQ を使用することをおすすめします。

  • OTA_HotelInvCountNotifRQ。物理的な客室数、つまり販売可能な客室の数を定義します。

  • TaxFeeInfo。宿泊施設ごとの税金と手数料を定義します（省略可）。OTA_HotelRateAmountNotifRQ メッセージに AmountAfterTax が指定されている場合、このメッセージは不要です。

  • Promotions。 （省略可）特定の予約、宿泊、ユーザー向けのプロモーション料金を定義します。

  • RateModifications。 （省略可）特定の予約、宿泊、ユーザーの料金変更ルールを定義します。

  • ExtraGuestCharges。任意。子どもと追加の大人に対する料金の設定方法を定義します。

各メッセージには、ユーザーが特定のチェックイン日とチェックアウト日および必要な定員を使用して宿泊施設を検索した際に表示される価格と空室状況を計算するために Google で使用する情報のサブセットが含まれます。

ARI の詳細については、XML リファレンスをご覧ください。

プッシュ メッセージ

ARI と宿泊施設の情報を更新するには、システムでデータが変更されるたびに、関連するメッセージを送信します。

メッセージを送信する際は、次のガイドラインを遵守してください。

  • Hotel Center の料金設定ページのセルフサービス ツールを使用して、Google のシステムで IP アドレスを追加または更新する。

  • エンドポイントには、次のベースパスを使用する。

    • https://www.google.com または Host: www.google.com Port: 443

  • HTTP POST メソッドを使用してメッセージを送信する。

  • Content-Type ヘッダーを application/xml に設定する。

  • アカウント レベルの最大更新レートは 1 秒あたり 400 メッセージです。この上限を超えると、エラーコード 6032 が返されます。

  • 更新されるデータに応じて、次のパスを使用する。

    • Transaction（宿泊施設データ）: /travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ: /travel/hotels/uploads/ota/hotel_rate_amount_notif
    • OTA_HotelAvailNotifRQ: /travel/hotels/uploads/ota/hotel_avail_notif
    • OTA_HotelInvCountNotifRQ: /travel/hotels/uploads/ota/hotel_inv_count_notif
    • TaxFeeInfo: /travel/hotels/uploads/taxes
    • Promotions: /travel/hotels/uploads/promotions
    • RateModifications: /travel/hotels/uploads/rate_modifications
    • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

受信した要求メッセージごとに、サーバーへの接続が成功した場合、Google は HTTP 200 OK で応答します。これには、更新が正常に適用されたか、警告やエラーが発生したかを示す応答メッセージの本文が含まれます。Google から HTTP エラーコードで応答があった場合は、メッセージを再送信します。HTTP レスポンスの本文に警告やエラーが含まれている場合は、メッセージを再送信する前に問題を修正する必要があります。また、Hotel Center の [フィードのステータス] ページでは、特定のメッセージで発生した問題を確認することもできます。

Google で公開中（LoG）

Google で公開（LoG）を使用すると、Google のウェブサイトにホテルを掲載できます。ホテルのデフォルトの LoG 値は true であるため、新しいホテルは Google に自動的に表示されます。

LoG を使用すると、Google 広告のステータスや Google での宿泊施設の料金の掲載の有無に関係なく、Hotel Center アカウントの広告と無料の予約リンクに対して、宿泊施設を有効または無効にできます。

ホテルの LoG 値を設定するには、Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API. と

LoG について詳しくは、Hotel Center ヘルプをご覧ください。

Travel Partner API, you can do the following: を使用する

  • 宿泊施設のステータスを確認するには、Hotel Center を使用するか、hotelViews.list エンドポイントを使用します。

  • hotelViews.list エンドポイントの liveOnGoogle = TRUE で filter パラメータを使用して、Google に表示されるすべてのホテルのリストを取得します。

  • hotelViews.summary を使用して、Google で公開されているプロパティの数など、特定のアカウントのプロパティの概要を取得します。

API を使用して LoG を設定する方法については、hotelViews.list の記事と API リファレンスをご覧ください。