Release Notes

Travel Partner API のバージョン 3 では、次のものにプログラムでアクセスできます。

  • Hotel Center と Google 広告間のアカウント リンクの管理
  • 選択したホテルの設定の管理
  • ブランドとアイコンの管理（クローズド ベータ版）
  • Property Performance Report Views Service を介したプロパティのパフォーマンス データ
  • ホテルビュー サービス経由のホテルデータ
  • 参加レポート ビュー サービス経由の参加レポート データ
  • Price Accuracy Views Service を介した料金の精度データ
  • Price Coverage Views Service を介した料金カバー率データ
  • Price Views Service を介した旅程と料金のデータ
  • 調整レポート サービスによるコミッション調整レポートの管理（宿泊課金型コミッション パートナーのみ）

エンドポイント

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

https://travelpartner.googleapis.com

Service エンドポイント
アカウントのリンク

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 の [アカウント] タブの [アカウント情報] ビューで確認できます。

変更履歴

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

HotelViewService

  • 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 レポート 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 バージョンの現在のスケジュールと、サポート終了日と廃止日の予定を示します。

バージョン サポート終了日 サポート終了日
v3.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 認証をご覧ください。