ARI の概要

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

宿泊プランベースの料金の配信モードであるプル型料金および変更済み料金とは異なり、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。（省略可）子供と追加の大人の料金を設定する方法を定義します。

各メッセージには、ユーザーが特定のチェックイン日とチェックアウト日、希望人数で宿泊施設を検索したときに、表示される料金と空室状況を計算するために使用される情報のサブセットが含まれています。

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

push メッセージ

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

メッセージを送信する場合は、次のガイドラインに従ってください。

  • Hotel Center の料金設定ページのセルフサービス ツールを使用して、システムで 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 値を設定する方法は 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 リファレンスをご覧ください。