ARI の概要

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

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

利点

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

  • 帯域幅の効率化: 転送する必要があるデータ量を削減することで、帯域幅の効率を高めます。毎晩 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 に設定する。

  • アカウント レベルの最大更新レートは 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 に表示されます。

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

ホテルの LoG 値を設定する方法は 2 つあります。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 リファレンスをご覧ください。