Trang này được dịch bởi Cloud Translation API.

Release Notes

Phiên bản 3 của Travel Partner API cho phép bạn truy cập theo chương trình vào:

Quản lý mối liên kết giữa tài khoản Hotel Center và Google Ads
Quản lý các chế độ cài đặt đã chọn cho khách sạn
Quản lý thương hiệu và biểu tượng (thử nghiệm kín)
Dữ liệu hiệu suất của cơ sở lưu trú thông qua Property Performance Report Views Service
Dữ liệu khách sạn thông qua Dịch vụ chế độ xem khách sạn
Dữ liệu báo cáo về số lần nắm được cơ hội đấu giá thông qua Participation Report Views Service
Dữ liệu về độ chính xác về giá thông qua Dịch vụ chế độ xem độ chính xác về giá
Dữ liệu về phạm vi bao phủ của giá thông qua Dịch vụ chế độ xem phạm vi bao phủ của giá
Dữ liệu về hành trình và giá thông qua Dịch vụ xem giá
Quản lý báo cáo đối chiếu phí hoa hồng thông qua Dịch vụ báo cáo đối chiếu (chỉ dành cho đối tác trả phí hoa hồng cho mỗi lượt lưu trú)

Điểm cuối

Bạn có thể truy cập vào các điểm cuối của Travel Partner API thông qua cú pháp REST-ful từ các lệnh gọi HTTPS. URL cơ sở cho tất cả các yêu cầu là:

https://travelpartner.googleapis.com

Điểm cuối dịch vụ
Liên kết tài khoản	Quản lý mối liên kết giữa tài khoản Google Ads và tài khoản 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`
Thương hiệu	Sửa đổi cấu hình Thương hiệu. (thử nghiệm khép kín) `POST /v3/accounts/account id/brands GET /v3/accounts/account id/brands PATCH /v3/accounts/account id/brands/brand id`
Khách sạn	Sửa đổi chế độ cài đặt khách sạn đã chọn. `POST /v3/accounts/account id/hotels:setLiveOnGoogle`
Lượt xem khách sạn	Trả về danh sách các lượt xem khách sạn hoặc một bản tóm tắt. `GET /v3/accounts/account id/hotelViews GET /v3/accounts/account id/hotelViews:summarize`
Biểu tượng	Quản lý biểu tượng. (thử nghiệm khép kín) `POST /v3/accounts/account id/icons GET /v3/accounts/account id/icons/icon id`
Chế độ xem báo cáo về mức độ tham gia	Trả về chế độ xem báo cáo về hoạt động tham gia hoặc trả về một tập hợp con đã lọc của dữ liệu trong chế độ xem bằng cách sử dụng một truy vấn. `GET /v3/accounts/account id/participationReportViews GET /v3/accounts/account id/participationReportViews:query`
Lượt xem độ chính xác về giá	Trả về một chế độ xem cụ thể về độ chính xác của giá, các chế độ xem có sẵn về độ chính xác hoặc một bản tóm tắt. `GET /v3/accounts/account id/priceAccuracyViews/report date GET /v3/accounts/account id/priceAccuracyViews GET /v3/accounts/account id/priceAccuracyViews:summarize`
Lượt xem độ bao phủ của giá	Trả về chế độ xem phạm vi bao phủ giá mới nhất hoặc toàn bộ nhật ký phạm vi bao phủ. `GET /v3/accounts/account id/priceCoverageViews:latest GET /v3/accounts/account id/priceCoverageViews`
Lượt xem giá	Trả về chế độ xem giá được yêu cầu một cách chi tiết. `GET /v3/accounts/account id/priceViews/partner hotel id`
Chế độ xem Báo cáo hiệu suất của tài sản	Trả về chế độ xem báo cáo hiệu suất của tài sản bằng cách sử dụng một truy vấn. `GET /v3/accounts/account id/participationReportViews:query`
Báo cáo đối chiếu	Tạo, xác thực và truy xuất báo cáo đối chiếu phí hoa hồng (chỉ dành cho Quảng cáo khách sạn). `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`

Bạn có thể tra cứu mã tài khoản trong chế độ xem Thông tin tài khoản của thẻ Tài khoản trong Hotel Ads Center.

Nhật ký thay đổi

Nhiều dịch vụ trong Travel Partner API phiên bản 2.1 đã được di chuyển sang API Google Ads. Do đó, Travel Partner API phiên bản 3 chỉ giữ lại các dịch vụ dành riêng cho khách sạn.

HotelViewService

HotelViewService.ListHotelViews (trước đây là Hotels API)
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/hotels thành https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews.
- Đã xoá tham số yêu cầu type.
- Đã xoá trường manifestOnly trong phản hồi.
- Một số trường đã được đổi tên.
HotelViewService.SummarizeHotelViews (trước đây là hotel_list_stats trong Scorecard API)
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats thành https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize.
- Một số trường đã được đổi tên.

ParticipationReportViewService (trước đây là opportunity_stats trong Scorecard API)

ParticipationReportService.QueryParticipationReport
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats thành https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query.
- Đã thêm các tham số truy vấn.
- Các trường đã được đổi tên và tái cấu trúc.

PriceAccuracyViewService (trước đây là API báo cáo price_accuracy)

PriceAccuracyViewService.ListPriceAccuracyViews
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy thành https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews.
- API mới trả về danh sách tên tài nguyên chế độ xem khách sạn thay vì danh sách ngày báo cáo như phiên bản trước.
PriceAccuracyViewService.ListPriceAccuracyViews
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909 thành https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909.
- Chúng tôi không còn hỗ trợ đầu ra CSV nữa.
- Một số trường đã được đổi tên.

PriceCoverageViewService

PriceAccuracyViewService.ListPriceCoverageViews (trước đây là price_coverage_stats_history trong Scorecard API)
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history thành https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews.
- Một số trường đã được đổi tên.
PriceAccuracyViewService.GetLatestPriceCoverageViews (trước đây là price_coverage_stats trong Scorecard API)
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats thành https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest.
- Một số trường đã được đổi tên.

PriceViewService (trước đây là Prices API)

PriceViewService.GetPriceView
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id thành https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id.
- Một số trường đã được đổi tên.
- Xoá thông tin về giá thầu khỏi phản hồi.

Các phương thức ReconciliationReportService (trước đây là Reconciliation Reports API)

ReconciliationReportService.ListReconciliationReports
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports thành https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
ReconciliationReportService.GetReconciliationReport
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename thành https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename.
ReconciliationReportService.CreateReconciliationReport
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports thành https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports.
ReconciliationReportService.ValidateReconciliationReport
- Điểm cuối API đã thay đổi từ https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate thành https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate.

Ngừng sử dụng

Không dùng nữa: cho biết phiên bản API sẽ tiếp tục hoạt động như dự kiến, nhưng có thể không được cập nhật các tính năng mới hoặc bản sửa lỗi. Ngoài ra, khi một phiên bản bị ngừng cung cấp, ngày ngừng cung cấp sẽ được xác định.
Ngừng hoạt động: cho biết phiên bản API đã bị xoá và không còn hoạt động nữa. Khoảng thời gian tối thiểu giữa thời điểm ngừng sử dụng và ngừng cung cấp là 3 tháng.

Bảng sau đây cho biết lịch trình hiện tại của các phiên bản API, cũng như ngày ngừng sử dụng và ngày ngừng hoạt động dự kiến:

Phiên bản	Ngày ngừng cung cấp	Ngày ngừng hoạt động
v3.0	Không áp dụng	Không áp dụng
v2.1	Tháng 9 năm 2019	Ngày 31 tháng 5 năm 2020
Phiên bản 2.0 (Bids API)	Tháng 2 năm 2018	Tháng 5 năm 2018
Phiên bản 2.0 (tất cả các API khác)	Tháng 9 năm 2019	Ngày 15 tháng 2 năm 2020
v1.2	Tháng 2 năm 2018	Tháng 5 năm 2018
v1.1	Tháng 6 năm 2016	Tháng 10 năm 2016
v1.0	Tháng 4 năm 2015	Tháng 10 năm 2015

Xác thực

Để truy cập vào Travel Partner API, các ứng dụng phải xác thực bằng phương thức xác thực OAuth2.

Để xem ví dụ về ứng dụng và thông tin bổ sung về cách sử dụng OAuth để kết nối với Travel Partner API, hãy tham khảo phần Xác thực API.

Release Notes Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.