Release Notes

Travel Partner API 第 3 版让您能够以编程方式访问：

  • 管理 Hotel Center 和 Google Ads 之间的帐号关联
  • 管理所选酒店设置
  • 品牌和图标管理（封闭式 Beta 版）
  • 通过媒体资源效果报告数据视图服务提供的媒体资源效果数据
  • 通过 Hotel Views 服务查看酒店数据
  • 通过参与报告观看次数服务的参与报告数据
  • 价格准确性数据（通过价格准确性视图服务）
  • 通过价格覆盖范围视图服务提供的价格覆盖范围数据
  • 通过价格视图服务提供的行程和价格数据
  • 通过对帐报告服务管理佣金对帐报告（仅限佣金按入住付费合作伙伴）

Endpoints

您可以通过 HTTPS 调用使用 RESTful 语法访问 Travel Partner API 端点。所有请求的基本网址如下：

https://travelpartner.googleapis.com

Service 端点
帐号关联

管理 Google Ads 帐号与 Hotel Center 帐号之间的关联。

POST /v3/accounts/account id/accountLinks
DELETE /v3/accounts/account id/accountLinks/account link id
GET /v3/accounts/account id/accountLinks/account link id
GET /v3/accounts/account id/accountLinks
PATCH /v3/accounts/account id/accountLinks/account link id

品牌

修改品牌配置。（封闭式 Beta 版）

POST /v3/accounts/account id/brands
GET /v3/accounts/account id/brands
PATCH /v3/accounts/account id/brands/brand id

酒店

修改所选的酒店设置。

POST /v3/accounts/account id/hotels:setLiveOnGoogle

酒店景观

返回酒店视图或摘要列表。

GET /v3/accounts/account id/hotelViews
GET /v3/accounts/account id/hotelViews:summarize

图标

管理图标。（封闭式 Beta 版）

POST /v3/accounts/account id/icons
GET /v3/accounts/account id/icons/icon id

参与报告查看次数

返回参与报告视图，或者使用查询返回过滤后的视图数据子集。

GET /v3/accounts/account id/participationReportViews
GET /v3/accounts/account id/participationReportViews:query

价格准确性视图

返回特定的价格准确性视图、可用精确度视图或摘要。

GET /v3/accounts/account id/priceAccuracyViews/report date
GET /v3/accounts/account id/priceAccuracyViews
GET /v3/accounts/account id/priceAccuracyViews:summarize

价格覆盖范围视图

返回最新的价格涵盖视图或完整的保修历史记录。

GET /v3/accounts/account id/priceCoverageViews:latest
GET /v3/accounts/account id/priceCoverageViews

价格视图

返回所请求的价格视图的完整详情。

GET /v3/accounts/account id/priceViews/partner hotel id

媒体资源效果报告视图

使用查询返回媒体资源效果报告视图。

GET /v3/accounts/account id/participationReportViews:query

对帐报告

创建、验证和检索佣金对帐报告（仅限酒店广告）。

POST /v3/accounts/account id/reconciliationReports
POST /v3/accounts/account id/reconciliationReports:validate
GET /v3/accounts/account id/reconciliationReports/datetime~filename
GET /v3/accounts/account id/reconciliationReports

您可以在 Hotel Ads Center 内帐号标签页的帐号信息视图下查找您的帐号 ID。

更新日志

Travel Partner API v2.1 中的许多服务都已迁移到 Google Ads API。因此，Travel Partner API v3 仅保留酒店专用服务。

酒店视图服务

  • HotelViewService.ListHotelViews（以前称为 Hotels API）
    • API 端点已从 https://www.googleapis.com/travelpartner/v2.1/4200042/hotels 更改为 https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews。
    • 移除了 type 请求参数。
    • 移除了响应中的字段 manifestOnly。
    • 部分字段已重命名。
  • 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。
    • 部分字段已重命名。

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。
    • 查询参数已添加。
    • 字段已重命名和重组。

PriceAccuracyViewService（以前称为 price_accuracy report API）

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • API 端点已从 https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy 更改为 https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews。
    • 新版 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 输出不再受支持。
    • 部分字段已重命名。

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。
    • 部分字段已重命名。
  • 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。
    • 部分字段已重命名。

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。
    • 部分字段已重命名。
    • 已从响应中移除出价信息。

对帐 Apigee 方法（以前称为 对帐报表 API）

  • ReconciliationReportService.ListReconciliationReports
    • API 端点已从 https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports 更改为 https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports。
  • 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。
  • ReconciliationReportService.CreateReconciliationReport
    • API 端点已从 https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports 更改为 https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports。
  • 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 版本已移除，不再可用。从弃用到停用之间的最短时间间隔为 3 个月。

下表显示了 API 版本的当前时间表，以及预计弃用和停用日期：

版本 弃用日期 停用日期
3.0 版 不适用 不适用
v2.1 2019 年 9 月 2016 年 5 月 31 日
v2.0 (Bids 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 月
1.0 版 2015 年 4 月 2015 年 10 月

身份验证

要访问 Travel Partner API，客户端必须使用 OAuth2 身份验证进行身份验证。

如需查看示例应用以及有关如何使用 OAuth 连接到 Travel Partner API 的其他信息，请参阅 API 身份验证。