クエリ メッセージは、料金やメタデータの更新に関する Google からのリクエストです。。 プル型料金と変更済み料金の両方で使用されている 配信モードを確認します。
クエリ メッセージのルート要素は <Query> です。
クエリ メッセージの構造は、メッセージの種類によって異なります。
料金設定: Google は、次の期間の料金の更新を求めるクエリ メッセージを送信します。 検索します。
メタデータ: Google が客室に関するデータをリクエストするクエリ メッセージを送信します。 指定したホテルのパッケージ情報を取得します。
Google がクエリ メッセージとライブに使用するエンドポイントを定義する 初期構成時の料金クエリ。詳しくは テクニカル アカウント マネージャー（TAM）にお問い合わせください。
Google は、Content-Type を使用したクエリ メッセージを HTTP POST リクエストとして送信します。
ヘッダーが「application/xml」に設定されていることまた、User-Agent ヘッダーは次のように設定されます。
Google-HotelAdsPrices。このルールの例外は、VM の手動テスト中は
Google-TravelAds-Live による価格エンドポイントの統合。これらのサンプルは
クエリに User-Agent ヘッダーが含まれている場合と含まれない場合があります。
クエリ メッセージの詳細な書式については、 クエリ XML リファレンス。
料金クエリ メッセージ
料金クエリ メッセージでは、対象となる宿泊施設または旅行プランの組み合わせが指定されます。 価格を指定します
サーバーは、料金クエリ メッセージを受信すると、
リクエストされた料金情報を含む <Transaction> メッセージ。
詳細については、料金の概要をご覧ください。
クエリ メッセージには、次の 3 つの特別なタイプがあります。
ライブ料金: 有効にすると、ユーザーが積極的に操作を行ったときにクエリが送信されます。 指定した宿泊施設または旅行プランの組み合わせの料金を閲覧し、 決まった時間で応答できます。
コンテキストあり: 有効にすると、ユーザー コンテキストの推奨事項が おすすめ情報には、Google から送信されるクエリに 特定の宿泊施設や旅行プランを検索する一般的なタイプのユーザー できます。これらの推奨事項に沿うことで、 選択できます。
Metadata:会議の客室とパッケージの詳細に対するリクエストです。 指定されています。
ライブ料金のクエリ
ライブ料金クエリは、Google からリアルタイムで ユーザーの検索内容に対して レスポンスを返すのが目的ですユーザーから ホテルまたは旅行プランの組み合わせで、料金データが利用できないか利用できないためです。 検索時に Google がお客様に料金の更新をリクエストします。あり ライブ料金クエリの場合、Google は料金を取得して 表示されます。
すべてのライブ料金クエリ リクエストには、応答時間の上限があります。 最大 4,000 ミリ秒ですこの上限はライブ料金クエリで指定します リクエストできます。制限時間内に応答できない場合は、 特定の機会への入札を逃すことが報告されます。ただし、 キャッシュして将来の機会に使用できるように、価格を提供する。 レスポンスの接続は 10 分間、または パートナーの設定で指定されている値を使用します。
ライブ料金クエリもコンテキストに基づくもので、 次のパラメータがあります: ユーザーの国、デバイスタイプ、定員（宿泊客の数）、 来客が大人か子供かといった情報ですライブ料金クエリでは ユーザーの検索内容に一致する最新の料金を表示できます。
ライブ料金クエリは、料金を設定する二次的なメカニズムとして使用する あります。料金変更の主要なメカニズムは、引き続きプル型または変更型 料金。ライブ料金クエリにより、Google が用意していないギャップを補完できます。 ホテルや旅行プランの組み合わせの料金
ライブ料金クエリの使用に関するルール
リクエストされた旅行プランがあるため、指定された旅行プランのデータはキャッシュに保存されていません 日付がかなり先の日付である、ホテルが非常に先の日付であるなど、異常である 検索頻度の低いものが表示されます
リクエストした日付がデフォルト以外の日付である。
: 注: デフォルトの日付はライブ料金クエリの対象外です。公開中 料金クエリは、デフォルト以外の日付に対してのみリクエストされます。
Google は通常、ライブ料金の結果をキャッシュに保存して、同じホテルまたは 再度クエリされることはありません。1 つのホテルまたは旅行プランの両方をリクエストできる 複数のホテルや 1 つの旅行プランの組み合わせを使用できます。
コンテキストを使用したライブ料金機能を使用すると、Google は、
ユーザーのデバイスタイプ（ユーザーの居住国）に基づくライブ料金リクエスト
宿泊人数（子供を含む）も確認できます。また、
クエリ メッセージとトランザクション メッセージが展開されて、
<Context> 要素。クエリ パラメータを定義します。料金情報提供元:
コンテキスト付きのライブ料金クエリは、条件の組み合わせとしてキャッシュに保存できます。
特定の宿泊人数に対する料金で、限定価格の場合は、
お客様の国またはデバイス向けであることを確認します。
コンテキスト クエリを使用
コンテキスト クエリは、Google が作成したシステムのデータベースを 指定された宿泊施設または旅行プランの組み合わせ。リストにはユーザーのリストと 予測することもできます。条件 限定価格が使用されている場合、 あらゆるユーザー コンテキストで料金が発生する場合があるため、 このユーザー コンテキストのリストを使用して対応を制限します。のみの復路価格 指定されたユーザー コンテキストが、関連するユーザークエリの大部分をカバーしている。
メタデータ クエリ メッセージ
メタデータ クエリ メッセージには、客室とパッケージの情報に関する詳細が含まれます。 表示されます。
メタデータ クエリ メッセージを受信したら、
リクエストされた宿泊施設の料金を指定する <Transaction> メッセージ
（<Result> 要素内）。
詳しくは、客室とパッケージのメタデータの定義をご覧ください。
制御クエリ
このセクションでは、どの宿泊施設と旅行プランを管理するかについて説明します。 Google からのクエリ メッセージの件名になります。
旅程の境界線
料金クエリの境界は、次を使用して決定します。
<ItineraryCapabilities>。日付の範囲を決定するルールを定義
サポートしている最大滞在日数などです
<MaxAdvancePurchase> と <MaxLengthOfStay> にはデフォルト値を設定できます。
すべてのホテルまたは旅行プランの組み合わせに適用されるため。また、これらを
ホテルグループ向けの設定です。
クエリ メッセージの例
このセクションでは、料金クエリ メッセージとメタデータの例をいくつか示します。 クエリ メッセージ。その他の例については、このモジュールの クエリ XML リファレンス。
旅行プランの例
次の例は、料金の更新をリクエストする料金 <Query> を示しています。
2023 年 5 月 23 日から、3 泊の空室がある 4 軒のホテルについて:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
次の例では、各ホテルの料金の更新をリクエストします。
5/23/18 - 6/26/18
ライブ料金クエリの例
次の例は、レスポンス時間の上限を含むライブ料金クエリを示しています。 500 ミリ秒以下とします。
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
be configured to be displayed, on request, by Google. This attribute is only
displayed for a Live Pricing Query request -->
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
received by. This element is only displayed for a Live Pricing Query request -->
<PropertyList>
<Property>6781291</Property>
</PropertyList>
<!-- Note that Context tags are potentially repeatable -->
<Context>
<!-- The total number of guests occupying the room (adults+children) -->
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
<Children>
<Child age="5"/>
</Children>
</OccupancyDetails>
<!-- The user was located in the US when this search was made -->
<UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
<UserDevice>mobile</UserDevice>
</Context>
</Query>
次の例では、1 つのホテルの料金をリクエストしています。
6/23/23 - 6/25/23
このクエリに対するトランザクション メッセージのサンプル レスポンスについては、 料金と客室在庫（トランザクション）XML リファレンスをご覧ください。
コンテキストを使用したクエリの例
次の例は、コンテキストを使用したクエリの例です。
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<PropertyContextList>
<PropertyContext>
<Property>8675309</Property>
<!-- In the future, occupancy and device might be specified -->
<Context><UserCountry>US</UserCountry></Context>
<Context><UserCountry>GB</UserCountry></Context>
</PropertyContext>
<PropertyContext>
<Property>8675310</Property>
<Property>8675311</Property>
<Context><UserCountry>CA</UserCountry></Context>
</PropertyContext>
</PropertyContextList>
</Query>
コンテキスト クエリでは、ユーザーの国のコンテキストのみを指定します。将来的には、 ユーザーのデバイスと宿泊人数もクエリで指定できます。
チェックイン期間
変更済み料金を使用する場合、クエリ メッセージの構造は チェックイン期間に使用するヒントの種類、 旅行プラン、期間指定旅行プランなどがありますそれぞれの詳細については ヒントの種類については、ヒント レスポンス メッセージをご覧ください。
次の例は、チェックイン日の料金 <Query> メッセージを示しています。
範囲:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
この例では、以下の滞在期間の料金更新をリクエストします（ ホテル）:
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
期間指定滞在
次の例は、期間指定プランの料金の <Query> メッセージを示しています。
滞在期間:
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
次の例では、各ホテルの料金の更新をリクエストします。
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
さらに、その日の前（ただしその日も含む）に始まる宿泊料金も適用できます。
5/20/23 - 5/23/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
メタデータ クエリ メッセージ
次の例は、メタデータをリクエストする <Query> メッセージを示しています。
いくつかの宿泊施設の客室とパッケージの情報が更新されます。
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<HotelInfoProperties>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</HotelInfoProperties>
</Query>
このタイプのクエリ メッセージには、次のようなトランザクション メッセージで応答します。 客室とパッケージのメタデータを定義します。詳細については、次をご覧ください: 客室とパッケージのメタデータの定義