ARI の概要

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

旅行プランベースの料金の配信モード、プル型料金、変更済み料金とは異なり、ARI フィードでは特定の料金や旅行プランに関するクエリは行われません。代わりに、料金の詳細、制限、空室状況の変更など、料金モデルに新しいデータや変更されたデータがある場合にメッセージを push します。

利点

ARI には次のようなメリットがあります。

  • 帯域幅の効率: 送信する必要があるデータの量を減らすことで、帯域幅の効率を高めます。Google は、毎晩の ARI データと増分変更のみを送信することで、さまざまな事前購入と滞在日数の値の料金と更新を計算できます。

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

  • 料金の一致率の向上: 詳細なデータをさまざまな旅行プランに組み合わせることで、料金の一致率（料金を含む旅行プランの数）を増やします。

  • 柔軟性: プロモーションとパッケージをより柔軟に提供できます。

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

リクエスト メッセージのタイプ

Google に送信される ARI メッセージは、ARI「リクエスト」メッセージと呼ばれます。その後、成功または失敗を示すレスポンス メッセージが返されます。

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 リファレンスをご覧ください。

push メッセージ

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. の 2 つの方法があります。

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 リファレンスをご覧ください。