Trang này trình bày một số lệnh gọi mẫu bằng Travel Partner API phiên bản 3.
Các điểm cuối của Travel Partner API chấp nhận cú pháp REST trong các lệnh gọi HTTPS. base_url cho tất cả các yêu cầu API là:
https://travelpartner.googleapis.com/v3/accounts/account_id
Để xem danh sách đầy đủ các trường yêu cầu và phản hồi, hãy xem danh mục tài nguyên API.
Báo cáo hiệu suất của cơ sở lưu trú
Dịch vụ Chế độ xem báo cáo hiệu suất của tài sản cung cấp khả năng truy vấn (nhận, lọc và phân đoạn) báo cáo hiệu suất của tài sản cho một tài khoản cụ thể.
Truy vấn báo cáo hiệu suất tài sản
Ví dụ sau đây lấy báo cáo hiệu suất của tài sản cho tất cả tài sản trong tài khoản 12345678
, được lọc theo ngày 11 tháng 5 năm 2022 và được nhóm theo mã khách sạn của đối tác.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId
Khách sạn
Dịch vụ xem khách sạn cung cấp danh sách tất cả khách sạn hoặc bản tóm tắt về các khách sạn cho một tài khoản cụ thể.
Nhận danh sách khách sạn
Ví dụ sau đây truy xuất danh sách tất cả khách sạn trong tài khoản 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews
Yêu cầu này chấp nhận các tham số truy vấn để điều hướng qua kết quả có nhiều trang:
GET base_url/hotelViews?pageSize=10&pageToken=11
Xem thông tin tóm tắt về tài sản
Ví dụ này lấy thông tin tóm tắt về các tài sản cho tài khoản 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize
Báo cáo về số lần nắm được cơ hội đấu giá
Dịch vụ xem báo cáo về hoạt động tham gia cung cấp khả năng truy vấn (lấy, lọc và phân đoạn) báo cáo về hoạt động tham gia cho một tài khoản cụ thể.
Truy vấn báo cáo về số lần nắm được cơ hội đấu giá
Ví dụ sau đây lấy báo cáo về mức độ tham gia cho tất cả tài sản trong tài khoản 12345678
và lọc báo cáo bằng ngày 4/10/20.
GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27
Tính chính xác về giá
Dịch vụ xem độ chính xác về giá cho phép truy xuất báo cáo và thẻ điểm về độ chính xác về giá cho một tài khoản cụ thể.
Nhận báo cáo về độ chính xác về giá
Ví dụ sau đây truy xuất báo cáo độ chính xác về giá vào ngày 26/8/2019 cho tài khoản 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826
Ngoài các tham số truy vấn thông thường để phân trang thông qua phản hồi, còn có một số tham số khác để đưa giá trùng khớp hoặc tín hiệu pixel vào kết quả.
Trong ví dụ này, báo cáo độ chính xác về giá vào ngày 26/8/2019 bao gồm giá khớp và tín hiệu pixel:
GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true
Liệt kê các báo cáo về độ chính xác của giá hiện có
Để xem danh sách các báo cáo có sẵn, hãy gửi yêu cầu sau:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews
Bạn có thể thêm tham số truy vấn thông thường để phân trang kết quả.
Nhận điểm độ chính xác về giá
Để nhận thẻ điểm về độ chính xác của giá, hãy sử dụng phương thức summarize
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize
Phạm vi bao phủ của giá
Dịch vụ xem phạm vi bao phủ của giá cung cấp báo cáo mới nhất về phạm vi bao phủ của giá hoặc toàn bộ nhật ký về phạm vi bao phủ của giá.
Xem số liệu thống kê mới nhất về phạm vi bao phủ của giá
Ví dụ sau đây truy xuất số liệu thống kê mới nhất về phạm vi bao phủ của giá cho tài khoản 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest
Nhận nhật ký về phạm vi bao phủ của giá
Yêu cầu này sẽ lấy toàn bộ nhật ký về phạm vi giá của một tài khoản:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews
Giá
Dịch vụ xem giá cho phép bạn truy xuất báo cáo giá cho một cơ sở lưu trú nhất định.
Nhận dữ liệu về giá cho một tài sản
Để nhận báo cáo định giá cho một khách sạn cụ thể (ID=101
) thuộc tài khoản 12345678
, hãy đưa ra yêu cầu này:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101
Báo cáo đối chiếu
Dịch vụ báo cáo đối chiếu cho phép bạn lấy danh sách báo cáo, tải một báo cáo cụ thể xuống, xác thực báo cáo đó, rồi tải báo cáo lên Google.
Nhận danh sách báo cáo đối chiếu
Ví dụ sau đây sẽ lấy danh sách báo cáo cho tài khoản 12345678
:
GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports
Bạn có thể thêm các tham số truy vấn ngày bắt đầu và ngày kết thúc (không bắt buộc) để giới hạn kết quả. Ví dụ: truy vấn này giới hạn báo cáo chỉ trong khoảng thời gian từ ngày 15/6/2019 đến ngày 15/9/2019:
GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15
Tải báo cáo đối chiếu xuống
Ví dụ này truy xuất báo cáo booking_report.csv
(dưới dạng phản hồi JSON) được tải lên tại 2019-08-26T12:00:00
:
GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv
Xác thực báo cáo đối chiếu
Bạn có thể sử dụng phương thức này để xác thực báo cáo trước khi tải lên. Việc xác thực báo cáo không đồng nghĩa với việc tải báo cáo lên.
Báo cáo đối chiếu được đưa vào nội dung yêu cầu, dưới dạng giá trị cho trường contents
. Báo cáo đối chiếu phải tuân thủ cú pháp được mô tả trong phần Báo cáo đối chiếu.
Ví dụ sau đây xác thực một báo cáo cho tài khoản 12345678
:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate
Tải báo cáo đối chiếu lên
Sau khi xác nhận rằng báo cáo đối chiếu là hợp lệ, bạn có thể tải báo cáo đó lên Google như trong ví dụ này:
POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports