Usage

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