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
用于更新多个房源的“在 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
验证对账报告。