Travel Partner API

Travel Partner API 为您提供了 Google Hotel Center 平台的 RESTful 接口。它可让应用高效地检索和更改 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
集合级自定义方法,可针对多个媒体资源更新“Live on 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.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
验证对帐报告。