Release Notes

Travel Partner API のバージョン 3 では、以下に対するプログラムによるアクセスが可能です。

  • Hotel Center と Google 広告の間のアカウントのリンクの管理
  • 選択したホテル設定の管理
  • ブランドとアイコンの管理（クローズド ベータ版）
  • プロパティ パフォーマンス レポート ビュー サービスを介したプロパティ パフォーマンス データ
  • ホテルビュー サービスによるホテルデータ
  • 参加レポートビュー サービスを通じた参加レポートデータ
  • 料金精度ビューサービスを利用した料金精度データ
  • 料金マッチビュー サービスによる価格保証データ
  • 料金ビューサービスによる宿泊プランと料金のデータ
  • 調整レポート サービスによるコミッション調整レポートの管理（コミッション（宿泊課金型）のパートナーのみ）

エンドポイント

Travel Partner API のエンドポイントには、HTTPS 呼び出しの REST 構文を使用してアクセスできます。すべてのリクエストのベース URL は次のとおりです。

https://travelpartner.googleapis.com

サービス エンドポイント
アカウントのリンク

Google 広告アカウントと Hotel Center アカウントのリンクを管理します。

POST /v3/accounts/account id/accountLinks
DELETE /v3/accounts/account id/accountLinks/account link id
GET /v3/accounts/account id/accountLinks/account link id
GET /v3/accounts/account id/accountLinks
PATCH /v3/accounts/account id/accountLinks/account link id

ブランド

ブランド設定を変更する。（クローズド ベータ版）

POST /v3/accounts/account id/brands
GET /v3/accounts/account id/brands
PATCH /v3/accounts/account id/brands/brand id

ホテル

選択したホテルの設定を変更します。

POST /v3/accounts/account id/hotels:setLiveOnGoogle

ホテルの表示回数

ホテルビューのリストまたは概要を返します。

GET /v3/accounts/account id/hotelViews
GET /v3/accounts/account id/hotelViews:summarize

アイコン

アイコンを管理します。（クローズド ベータ版）

POST /v3/accounts/account id/icons
GET /v3/accounts/account id/icons/icon id

参加レポートの閲覧

参加レポートビューを返すか、クエリを使用してビューデータのフィルタされたサブセットを返します。

GET /v3/accounts/account id/participationReportViews
GET /v3/accounts/account id/participationReportViews:query

料金精度ビュー

特定の料金精度ビュー、利用可能な精度ビュー、または概要を返します。

GET /v3/accounts/account id/priceAccuracyViews/report date
GET /v3/accounts/account id/priceAccuracyViews
GET /v3/accounts/account id/priceAccuracyViews:summarize

料金マッチ率ビュー

最新の価格一致率ビューまたはすべてのカバレッジ履歴を返します。

GET /v3/accounts/account id/priceCoverageViews:latest
GET /v3/accounts/account id/priceCoverageViews

料金ビュー

リクエストされた料金ビューの詳細を返します。

GET /v3/accounts/account id/priceViews/partner hotel id

プロパティの掲載結果レポート

クエリを使用してプロパティのパフォーマンス レポート ビューを返します。

GET /v3/accounts/account id/participationReportViews:query

調整レポート

コミッション照合レポートを作成、検証、取得します（ホテル広告のみ）。

POST /v3/accounts/account id/reconciliationReports
POST /v3/accounts/account id/reconciliationReports:validate
GET /v3/accounts/account id/reconciliationReports/datetime~filename
GET /v3/accounts/account id/reconciliationReports

アカウント ID は、Hotel Ads Center の [Account] タブの [Account Info] で確認できます。

変更履歴

Travel Partner API v2.1 の多くのサービスが Google Ads API に移行されました。そのため、Travel Partner API v3 ではホテル固有のサービスのみが保持されます。

ホテルビュー サービス

  • HotelViewService.ListHotelViews（旧 Hotels API）
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/hotels から https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews に変更されました。
    • type リクエスト パラメータを削除しました。
    • レスポンスのフィールド manifestOnly を削除しました。
    • 一部の項目の名前が変更されました。
  • HotelViewService.SummarizeHotelViews（Scorecard API の以前の hotel_list_stats）
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats から https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize に変更されました。
    • 一部の項目の名前が変更されました。

ParticipationReportViewService（以前の Scorecard API の Opportunity_stats）

  • ParticipationReportService.QueryParticipationReport
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats から https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query に変更されました。
    • クエリ パラメータが追加されました。
    • フィールドの名前を変更し、再構成しました。

PriceAccuracyViewService（旧 price_accuracy report API）

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy から https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews に変更されました。
    • 新しい API ではホテルビュー リソース名のリストが返されます。前のバージョンでは、レポートの日付のリストが返されます。
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 から https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909 に変更されました。
    • CSV 出力のサポートは終了しました。
    • 一部の項目の名前が変更されました。

PriceCoverageViewService

  • PriceAccuracyViewService.ListPriceCoverageViews（Scorecard API の以前の price_coverage_stats_history）
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history から https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews に変更されました。
    • 一部の項目の名前が変更されました。
  • PriceAccuracyViewService.GetLatestPriceCoverageViews（Scorecard API の以前の price_coverage_stats）
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats から https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest に変更されました。
    • 一部の項目の名前が変更されました。

PriceViewService（旧 Prices API）

  • PriceViewService.GetPriceView
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id から https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id に変更されました。
    • 一部の項目の名前が変更されました。
    • 入札レスポンス情報をレスポンスから削除しました。

ReconciliationReportService メソッド（旧 Reconciliation Reports API）

  • ReconciliationReportService.ListReconciliationReports
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports から https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports に変更されました。
  • ReconciliationReportService.GetReconciliationReport
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename から https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename に変更されました。
  • ReconciliationReportService.CreateReconciliationReport
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports から https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports に変更されました。
  • ReconciliationReportService.ValidateReconciliationReport
    • API エンドポイントが https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate から https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate に変更されました。

非推奨

サポート終了
は、API のバージョンが想定どおりに機能し続けるものの、新しい機能の追加やバグの修正が行われない可能性があることを示します。また、バージョンが非推奨になると、廃止日も決定されます。
夕暮れ
は、API のバージョンが削除され、利用できなくなったことを示します。サポートの終了からサポート終了までの間の最短期間は 3 か月です。

次の表に、API バージョンの現在のスケジュール、非推奨の予定日、廃止予定日を示します。

バージョン サポート終了日 廃止日
バージョン 3.0 なし なし
v2.1 2019 年 9 月 2020 年 5 月 31 日
v2.0（Bids API） 2018 年 2 月 2018 年 5 月
v2.0（その他のすべての API） 2019 年 9 月 2020 年 2 月 15 日
v1.2 2018 年 2 月 2018 年 5 月
v1.1 2016 年 6 月 2016 年 10 月
v1.0 2015 年 4 月 2015 年 10 月

認証

Travel Partner API にアクセスするには、クライアントが OAuth2 認証を使用して認証を行う必要があります。

サンプル アプリケーションや、OAuth を使用して Travel Partner API に接続する詳細情報については、API 認証をご覧ください。