借助 Travel Partner API 第 3 版,您可以通过编程方式访问以下内容:
- 管理 Hotel Center 与 Google Ads 之间的账号关联
- 管理所选酒店设置
- 品牌和图标管理(封闭式 Beta 版)
- 通过“房源效果报告视图”服务获取房源效果数据
- 通过酒店视图服务获取酒店数据
- 通过 Participation Report Views Service 获取的参与度报告数据
- 通过价格准确性视图服务获取价格准确性数据
- 通过 Price Coverage Views Service 获取价格覆盖率数据
- 通过 Price Views Service 获取的行程和价格数据
- 通过对账报告服务管理佣金对账报告(仅限按入住付费的合作伙伴)
端点
可通过 HTTPS 调用中的 RESTful 语法访问 Travel Partner API 端点。所有请求的基本网址为:
https://travelpartner.googleapis.com
Service 端点 | |
---|---|
账号关联 | 管理 Google Ads 账号与 Hotel Center 账号之间的关联。
|
品牌方 | 修改品牌配置。(封闭式 Beta 版)
|
Google 酒店 | 修改所选酒店设置。
|
酒店视图 | 返回酒店视图列表或摘要。
|
图标 | 管理图标。(封闭式 Beta 版)
|
参与情况报告视图 | 返回参与度报告视图,或者通过使用查询返回视图中经过过滤的数据子集。
|
价格精准视图 | 返回特定价格准确性视图、可用的准确性视图或摘要。
|
价格覆盖率视图 | 返回最新的价格覆盖面视图或整个覆盖面历史记录。
|
价格查看次数 | 返回所请求价格视图的完整详细信息。
|
“媒体资源效果”报告视图 | 使用查询返回房源效果报告视图。
|
对账报告 | 创建、验证和检索佣金对账报告(仅限酒店广告)。
|
您可以在 Hotel Ads Center 的账号标签页的账号信息视图下查找您的账号 ID。
更新日志
Travel Partner API v2.1 中的许多服务已迁移到 Google Ads API。因此,Travel Partner API v3 仅保留了酒店专用服务。
HotelViewService
HotelViewService.ListHotelViews
(以前称为 Hotels API)- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/hotels
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews
。 - 移除了
type
请求参数。 - 移除了响应中的
manifestOnly
字段。 - 部分字段已更名。
- API 端点已从
HotelViewService.SummarizeHotelViews
(以前在 Scorecard API 中为hotel_list_stats
)- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize
。 - 部分字段已更名。
- API 端点已从
ParticipationReportViewService(以前在 Scorecard API 中称为 opportunity_stats)
ParticipationReportService.QueryParticipationReport
- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query
。 - 已添加查询参数。
- 字段已重命名和重组。
- API 端点已从
PriceAccuracyViewService(以前称为 price_accuracy 报告 API)
PriceAccuracyViewService.ListPriceAccuracyViews
- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews
。 - 新 API 会返回酒店视图资源名称列表,而旧版本会返回报告日期列表。
- API 端点已从
PriceAccuracyViewService.ListPriceAccuracyViews
- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909
。 - 不再支持 CSV 输出。
- 部分字段已更名。
- API 端点已从
PriceCoverageViewService
PriceAccuracyViewService.ListPriceCoverageViews
(以前在 Scorecard API 中为price_coverage_stats_history
)- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews
。 - 部分字段已更名。
- API 端点已从
PriceAccuracyViewService.GetLatestPriceCoverageViews
(以前在 Scorecard API 中为price_coverage_stats
)- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest
。 - 部分字段已更名。
- API 端点已从
PriceViewService(以前称为 Prices API)
PriceViewService.GetPriceView
- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id
。 - 部分字段已更名。
- 从响应中移除了出价信息。
- API 端点已从
ReconciliationReportService 方法(以前称为“对账报告 API”)
ReconciliationReportService.ListReconciliationReports
- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports
。
- API 端点已从
ReconciliationReportService.GetReconciliationReport
- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename
。
- API 端点已从
ReconciliationReportService.CreateReconciliationReport
- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports
。
- API 端点已从
ReconciliationReportService.ValidateReconciliationReport
- API 端点已从
https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate
更改为https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate
。
- API 端点已从
弃用
- 已弃用
- 表明 API 版本将继续按预期运行,但可能不会再有新功能或问题修复的更新。此外,当某个版本被弃用时,系统会确定其停用日期。
- 已停用
- 表示 API 版本会被移除,不再可用。从弃用到停用的最短时间为 3 个月。
下表显示了当前 API 版本的时间表,以及预计的弃用日期和停用日期:
版本 | 下架日期 | 停用日期 |
---|---|---|
v3.0 | 不适用 | 不适用 |
v2.1 | 2019 年 9 月 | 2016 年 5 月 31 日 |
v2.0(出价 API) | 2018 年 2 月 | 2018 年 5 月 |
v2.0(所有其他 API) | 2019 年 9 月 | 2020 年 2 月 15 日 |
v1.2 | 2018 年 2 月 | 2018 年 5 月 |
v1.1 | 2016 年 6 月 | 2016 年 10 月 |
v1.0 | 2015 年 4 月 | 2015 年 10 月 |
身份验证
如需访问 Travel Partner API,客户端必须使用 OAuth2 身份验证进行身份验证。
如需查看示例应用以及有关使用 OAuth 连接到 Travel Partner API 的其他信息,请参阅 API 身份验证。