Travel Partner API 提供 Google Hotel Center 平台符合 REST 樣式的介面。可讓應用程式有效率地擷取及變更 Hotel Center 資料,因此適合管理大型或複雜的帳戶。
- REST 資源:v3.accounts.accountLinks
- REST 資源:v3.accounts.brands
- REST 資源:v3.accounts.freeBookingLinksReportViews
- REST 資源:v3.accounts.hotelViews
- REST 資源:v3.accounts.hotels
- REST 資源:v3.accounts.icons
- REST 資源:v3.accounts.participationReportViews
- REST 資源:v3.accounts.priceAccuracyViews
- REST 資源:v3.accounts.priceCoverageViews
- REST 資源:v3.accounts.priceViews
- REST 資源:v3.accounts.propertyPerformanceReportViews
- REST 資源:v3.accounts.reconciliationReporting
服務:travelpartner.googleapis.com
如要呼叫這項服務,建議您使用 Google 提供的用戶端程式庫。如果您的應用程式需要使用自己的程式庫來呼叫此服務,請在發出 API 要求時提供下列資訊。
探索文件
探索文件是一種機器可解讀的規格,用於說明和使用 REST API。此文件用於建構用戶端程式庫、IDE 外掛程式,以及與 Google API 互動的其他工具。一項服務可能會提供多個探索文件。這項服務提供下列探索文件:
服務端點
服務端點是指定 API 服務網路位址的基準網址。一項服務可能有多個服務端點。這項服務有以下服務端點,且下方的 URI 皆以此服務端點為基準:
https://travelpartner.googleapis.com
REST 資源:v3.accounts.accountLinks
方法 | |
---|---|
create |
POST /v3/{parent=accounts/*}/accountLinks 建立 Hotel Center 帳戶和 Google Ads 帳戶之間的連結。 |
delete |
DELETE /v3/{name=accounts/*/accountLinks/*} 刪除帳戶連結。 |
get |
GET /v3/{name=accounts/*/accountLinks/*} 傳回與要求網址中指定的帳戶連結資源名稱相關聯的 AccountLink 執行個體。 |
list |
GET /v3/{parent=accounts/*}/accountLinks 傳回 Hotel Center 帳戶的帳戶連結。 |
patch |
PATCH /v3/{accountLink.name=accounts/*/accountLinks/*} 更新帳戶連結的帳戶連結目標。 |
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 |
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 驗證對帳報告。 |