Travel Partner API

Travel Partner API 提供 RESTful 介面，可連線至 Google Hotel Center 平台。應用程式可藉此有效擷取及變更 Hotel Center 資料，因此適合用來管理大型或複雜的帳戶。

服務：travelpartner.googleapis.com

如要呼叫這項服務，建議您使用 Google 提供的用戶端程式庫。如果您的應用程式需要使用自己的程式庫呼叫這項服務，請在發出 API 要求時使用下列資訊。

探索文件

探索文件是一種機器可解讀的規格，用於說明和使用 REST API。此文件用於建構用戶端程式庫、IDE 外掛程式，以及與 Google API 互動的其他工具。一項服務可能會提供多個探索文件。這項服務提供下列探索文件：

服務端點

服務端點是指定 API 服務網路位址的基準網址。一項服務可能有多個服務端點。這項服務有以下服務端點，且下方的 URI 皆以此服務端點為基準：

  • https://travelpartner.googleapis.com

REST 資源：v3.accounts.brands

方法
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

方法
query
(deprecated)		 GET /v3/{name=accounts/*}/freeBookingLinksReportViews:query
已淘汰：請改用 PropertyPerformanceReportService.QueryPropertyPerformanceReport，該方法也提供曝光報表。

REST 資源：v3.accounts.hotelViews

方法
list GET /v3/{parent=accounts/*}/hotelViews
傳回飯店檢視畫面清單。
summarize GET /v3/{parent=accounts/*}/hotelViews:summarize
傳回飯店的摘要資訊。

REST 資源：v3.accounts.hotels

方法
setLiveOnGoogle POST /v3/{account=accounts/*}/hotels:setLiveOnGoogle
集合層級的自訂方法，可更新多個房源的「在 Google 上顯示」狀態。

REST 資源：v3.accounts.icons

方法
create POST /v3/{parent=accounts/*}/icons
上傳新圖示並開始審查程序。
get GET /v3/{name=accounts/*/icons/*}
傳回與要求 URI 中指定圖示資源名稱相關聯的 Icon 執行個體。
list GET /v3/{parent=accounts/*}/icons
傳回合作夥伴帳戶的 Icon。

REST 資源：v3.accounts.listings

方法
verify POST /v3/{parent=accounts/*}/listings:verify
僅為 VR 合作夥伴傳回有資料問題的已驗證房源，以及放送資格。

REST 資源：v3.accounts.participationReportViews

方法
query GET /v3/{name=accounts/*}/participationReportViews:query
可查詢 (取得、篩選及區隔) 特定帳戶的參與度報表。

REST 資源：v3.accounts.priceAccuracyViews

方法
get GET /v3/{name=accounts/*/priceAccuracyViews/*}
傳回所要求的價格準確度檢視畫面，並提供完整詳細資料。
list GET /v3/{parent=accounts/*}/priceAccuracyViews
列出可用的價格準確度檢視畫面。
summarize GET /v3/{parent=accounts/*}/priceAccuracyViews:summarize
傳回價格準確度摘要。

REST 資源：v3.accounts.priceCoverageViews

方法
getLatest GET /v3/{parent=accounts/*}/priceCoverageViews:latest
傳回最新價格涵蓋範圍檢視畫面，並提供完整詳細資料。
list GET /v3/{parent=accounts/*}/priceCoverageViews
傳回整個價格涵蓋範圍記錄。

REST 資源：v3.accounts.priceViews

方法
get GET /v3/{name=accounts/*/priceViews/*}
傳回所要求價格檢視畫面的完整詳細資料。

REST 資源：v3.accounts.propertyPerformanceReportViews

方法
query GET /v3/{name=accounts/*}/propertyPerformanceReportViews:query
可查詢 (取得、篩選及區隔) 特定帳戶的免費預訂連結報表。

REST 資源：v3.accounts.reconciliationReports

方法
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
驗證對帳報告。