Travel Partner API

Travel Partner API 提供 Google Hotel Center 平台符合 REST 樣式的介面。可讓應用程式有效率地擷取及變更 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.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.reconciliationReporting

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