Release Notes

Phiên bản 3 của API Đối tác du lịch cho phép bạn truy cập theo phương thức lập trình để:

  • Quản lý việc liên kết tài khoản giữa Hotel Center và Google Ads
  • Quản lý chế độ cài đặt khách sạn đã chọn
  • Quản lý thương hiệu và biểu tượng (thử nghiệm kín)
  • Dữ liệu về hiệu suất của cơ sở lưu trú thông qua Dịch vụ xem báo cáo hiệu suất của cơ sở lưu trú
  • 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ề trạng thái tham gia thông qua Dịch vụ chế độ xem báo cáo tham gia
  • Dữ liệu về mức độ chính xác về giá thông qua Dịch vụ chế độ xem về mức độ chính xác về giá
  • Dữ liệu về phạm vi bao phủ của giá thông qua Dịch vụ xem giá trong phạm vi giá
  • Dữ liệu về lịch trình và giá qua Dịch vụ Chế độ 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ú)

Thiết bị đầu cuối

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

https://travelpartner.googleapis.com

Điểm cuối dịch vụ
Đường liên kết đến 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 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 các chế độ cài đặt khách sạn đã chọn.

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

Chế độ xem khách sạn

Trả về danh sách các chế độ 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 kín)

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

Số lượt xem báo cáo tham gia

Trả về chế độ xem báo cáo tham gia hoặc bằng cách sử dụng truy vấn trả về tập hợp con đã lọc của dữ liệu chế độ xem.

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

Số lượt xem mức độ chính xác về giá

Trả về một chế độ xem chính xác về 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

Chế độ xem mức độ phù hợp của giá

Trả về chế độ xem phạm vi bao phủ 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

Chế độ xem giá

Trả về thông tin chi tiết của giá mà bạn yêu cầu.

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 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ều chỉnh 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ể tìm mã tài khoản trong chế độ xem Thông tin tài khoản trên thẻ Tài khoản trong Trung tâm Quảng cáo khách sạn.

Nhật ký thay đổi

Nhiều dịch vụ trong API Đối tác du lịch phiên bản 2.1 đã được di chuyển sang API Google Ads. Do đó, API Đối tác du lịch 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à API khách sạn)
    • Đ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 API Thẻ điểm)
    • Đ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.

ThamnViewViewService (trước đây làOpportunity_stats trong API Thẻ điểm)

  • 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à được cấu trúc lại.

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

  • 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ì phiên bản trước đó. API này trả về danh sách ngày báo cáo.
  • 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.
    • Một số trường đã được đổi tên.

PriceCoverageViewService

  • PriceAccuracyViewService.ListPriceCoverageViews (trước đây là price_coverage_stats_history trong API Thẻ điểm)
    • Đ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 API Thẻ điểm)
    • Đ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.
    • Đã xóa thông tin giá thầu khỏi mục phản hồi.

Phương thức báo cáo điều chỉnh (trước đây là API Báo cáo đối chiếu)

  • 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.

Không dùng nữa

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ể sẽ 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 phiên bản không được dùng nữa, ngày hoàng hôn sẽ được xác định.
Hoàng hôn
cho biết phiên bản API đã bị xoá và không còn tồn tại. Khoảng thời gian tối thiểu từ khi ngừng cho đến lúc ngừng hoạt động là 3 tháng.

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

Phiên bản Ngày ngừng sử dụng Ngày hoàng hôn
phiên bản 3.0 Không áp dụng Không áp dụng
phiên bản 2.1 Tháng 9 năm 2019 Ngày 31 tháng 5 năm 2020
phiên bản 2.0 (API giá thầu) Thá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
phiên bản 1.2 Tháng 2 năm 2018 Tháng 5 năm 2018
phiên bản 1.1 Tháng 6 năm 2016 Tháng 10 năm 2016
phiên bản 1.0 Tháng 4 năm 2015 Tháng 10 năm 2015

Xác thực

Để truy cập API Đối tác du lịch, khách hàng phải xác thực bằng tính năng xác thực OAuth2.

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