Release Notes

Travel Partner API 3 版可讓您以程式輔助的方式存取：

  • 管理 Hotel Center 和 Google Ads 之間的連結
  • 管理所選飯店設定
  • 品牌和圖示管理 (封閉式 Beta 版)
  • 透過資源成效報表資料檢視服務提供資源成效資料
  • 透過 Hotel View 服務的飯店資料
  • 透過參與報表資料檢視服務參與的測試資料
  • 透過價格準確性資料服務提供價格準確性資料
  • 透過價格涵蓋範圍檢視服務提供價格涵蓋範圍資料
  • 透過價格檢視服務提供的行程和價格資料
  • 透過對帳報告服務管理佣金對帳報告 (僅限按入住天數付費)

端點

您從 HTTPS 呼叫可透過符合 REST 樣式的語法存取 Travel Partner API 端點。所有要求的基準網址如下：

https://travelpartner.googleapis.com

Service 端點
帳戶連結

管理 Google Ads 帳戶和 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

品牌

修改品牌設定。(封閉式 Beta 版)

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

圖示

管理圖示(封閉式 Beta 版)

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。

變更記錄

Travel Partner API 2.1 版中的許多服務已遷移至 Google Ads API。因此，Travel Partner API 第 3 版只會保留飯店專屬服務。

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 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 輸出。
    • 部分欄位已重新命名。

價格範圍檢視服務

  • 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 版 不適用 不適用
2.1 版 2019 年 9 月 2020 年 5 月 31 日
2.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 月
1.0 版 2015 年 4 月 2015 年 10 月

驗證

如要存取 Travel Partner API，用戶端必須使用 OAuth2 驗證進行驗證。

如需應用程式範例，以及關於使用 OAuth 連線至 Travel Partner API 的其他資訊，請參閱 API 驗證。