Travel Partner API

Travel Partner API は、Google Hotel Center プラットフォームへの RESTful インターフェースを提供します。この API を使用すると、アプリは Hotel Center のデータを効率的に取得、変更できるため、大規模または複雑なアカウントの管理に適しています。

サービス: travelpartner.googleapis.com

このサービスを呼び出すには、Google が提供するクライアント ライブラリを使用することをおすすめします。アプリケーションで独自のライブラリを使用してこのサービスを呼び出す必要がある場合は、API リクエストを行うときに次の情報を使用してください。

ディスカバリ ドキュメント

ディスカバリ ドキュメントは、REST API を記述して使用するための機械可読仕様です。クライアント ライブラリ、IDE プラグイン、Google API と連携するその他のツールのビルドに使用されます。1 つのサービスで複数のディスカバリ ドキュメントを提供できます。このサービスには、次の検索ドキュメントが用意されています。

サービス エンドポイント

サービス エンドポイントは、API サービスのネットワーク アドレスを指定するベース URL です。1 つのサービスに複数のサービス エンドポイントが存在する場合があります。このサービスには次のサービス エンドポイントがあり、以下のすべての URI がこのサービス エンドポイントに関連しています。

  • https://travelpartner.googleapis.com

REST リソース: v3.accounts.brands

Methods
create POST /v3/{parent=accounts/*}/brands
新しいブランドを作成します。
get GET /v3/{name=accounts/*/brands/*}
リクエスト URI とブランド リソース名に関連付けられた Brand インスタンスを返します。
list GET /v3/{parent=accounts/*}/brands
パートナー アカウントのブランドを返します。
patch PATCH /v3/{brand.name=accounts/*/brands/*}
ブランドを更新します。

REST リソース: v3.accounts.freeBookingLinksReportViews

Methods
query
(deprecated)		 GET /v3/{name=accounts/*}/freeBookingLinksReportViews:query
非推奨: PropertyPerformanceReportService.QueryPropertyPerformanceReport を使用してください。代わりに、インプレッション レポートもあります。

REST リソース: v3.accounts.hotelViews

Methods
list GET /v3/{parent=accounts/*}/hotelViews
ホテルビューのリストを返します。
summarize GET /v3/{parent=accounts/*}/hotelViews:summarize
ホテルに関する要約情報を返します。

REST リソース: v3.accounts.hotels

Methods
setLiveOnGoogle POST /v3/{account=accounts/*}/hotels:setLiveOnGoogle
複数のプロパティで「Google で公開中」のステータスを更新するためのコレクション レベルのカスタム メソッド。

REST リソース: v3.accounts.icons

Methods
create POST /v3/{parent=accounts/*}/icons
新しいアイコンをアップロードして、審査プロセスを開始します。
get GET /v3/{name=accounts/*/icons/*}
リクエスト URI で指定されたアイコン リソース名に関連付けられた Icon インスタンスを返します。
list GET /v3/{parent=accounts/*}/icons
パートナー アカウントの Icon を返します。

REST リソース: v3.accounts.participationReportViews

Methods
query GET /v3/{name=accounts/*}/participationReportViews:query
特定のアカウントの参加レポートについて、クエリ（取得、フィルタ、セグメント化）を行うことができます。

REST リソース: v3.accounts.priceAccuracyViews

Methods
get GET /v3/{name=accounts/*/priceAccuracyViews/*}
リクエストされた料金精度ビューの詳細を返します。
list GET /v3/{parent=accounts/*}/priceAccuracyViews
料金の精度を表示するリストを表示します。
summarize GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize
料金の精度の概要を返します。

REST リソース: v3.accounts.priceCoverageViews

Methods
getLatest GET /v3/{parent=accounts/*}/priceCoverageViews:latest
最新の料金マッチ率を詳細に返します。
list GET /v3/{parent=accounts/*}/priceCoverageViews
料金マッチ履歴全体を返します。

REST リソース: v3.accounts.priceViews

Methods
get GET /v3/{name=accounts/*/priceViews/*}
リクエストされた料金ビューの詳細を返します。

REST リソース: v3.accounts.propertyPerformanceReportViews

Methods
query GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query
特定のアカウントについて、プロパティ パフォーマンス リンクのレポートをクエリ（取得、フィルタ、セグメント化）できます。

REST リソース: v3.accounts.reconciliationReports

Methods
create POST /v3/{parent=accounts/*}/reconciliationReports
調整レポートを作成して Google にアップロードします。
get GET /v3/{name=accounts/*/reconciliationReports/*}
調整レポートを返します。
list GET /v3/{parent=accounts/*}/reconciliationReports
作成した調整レポートの名前のリストを返します。
validate POST /v3/{parent=accounts/*}/reconciliationReports:validate
調整レポートを検証します。