Usage

Trang này trình bày một số lệnh gọi mẫu bằng API Đối tác du lịch phiên bản 3.

Điểm cuối API Đối tác du lịch sử dụng cú pháp REST-ful thông qua các lệnh gọi HTTPS. base_url cho tất 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 hoạt động của tài sản

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 (lấy, lọc và phân đoạn) một báo cáo hiệu suất tài sản cho một tài khoản cụ thể.

Truy vấn báo cáo hiệu suất của cơ sở lưu trú

Ví dụ sau đây nhận được báo cáo hiệu suất của cơ sở lưu trú cho tất cả các cơ sở lưu trú trong tài khoản 12345678. Dữ liệu này được lọc theo ngày ngày 11 tháng 5 năm 2022 và được nhóm theo mã khách sạn đố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ụ Chế độ xem khách sạn cung cấp danh sách tất cả cá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ể.

Lấy danh sách khách sạn

Ví dụ sau đây truy xuất danh sách tất cả các khách sạn trong tài khoản 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelviews

Yêu cầu chấp nhận các tham số truy vấn để điều hướng qua các kết quả nhiều trang:

GET base_url/hotelviews?pageSize=10&pageToken=11

Lấy thông tin tóm tắt về cơ sở lưu trú

Dưới đây là một bản tóm tắt về các thuộc tính cho tài khoản 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelviews:summarize

Báo cáo tham gia

Dịch vụ chế độ xem báo cáo tham gia cung cấp khả năng truy vấn (nhận, lọc và phân đoạn) một báo cáo tham gia cho một tài khoản cụ thể.

Truy vấn báo cáo về việc tham gia

Ví dụ sau đây tải báo cáo tham gia cho tất cả các tài sản trong tài khoản 12345678 và lọc báo cáo theo ngày 10/4/2020.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27

Sự chính xác về giá

Dịch vụ chế độ xem về mức độ chính xác về giá cho phép truy xuất báo cáo và mức độ chính xác về giá cho một tài khoản cụ thể.

Nhận báo cáo về mức độ chính xác về giá

Ví dụ sau đây truy xuất báo cáo về mức độ chính xác về giá vào ngày 26 tháng 8 năm 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 của việc phân trang thông qua phản hồi, còn có một vài tham số khác để thêm giá hoặc tín hiệu pixel phù hợp trong kết quả.

Trong ví dụ này, báo cáo về mức độ chính xác về giá vào ngày 26/8/2019 bao gồm cả các mức giá trùng 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ề mức độ chính xác về giá

Để nhận danh sách các báo cáo hiện có, hãy gửi yêu cầu này:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews

Bạn có thể thêm các tham số truy vấn thông thường để phân trang thông qua kết quả.

Nhận mức độ chính xác về giá

Để lấy thẻ điểm về mức độ chính xác về giá, hãy sử dụng phương thức summarize:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize

Phạm vi giá

Dịch vụ chế độ xem mức độ phù hợp của giá cung cấp báo cáo mới nhất về phạm vi bao phủ giá hoặc toàn bộ lịch sử phạm vi bao phủ giá.

Đang tải số liệu thống kê mới nhất về phạm vi bao phủ 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 tài khoản 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest

Xem lịch sử phạm vi giá

Yêu cầu này yêu cầu toàn bộ lịch sử phạm vi giá cho 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 về giá của một cơ sở lưu trú.

Lấy dữ liệu về giá của một cơ sở lưu trú

Để xem báo cáo về giá cho một khách sạn cụ thể (ID=101) thuộc tài khoản 12345678, hãy gửi 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

Nhận danh sách báo cáo đối chiếu

Ví dụ sau đây nhận một danh sách các báo cáo cho tài khoản 12345678:

GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports

Bạn có thể bao gồm các thông 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 chỉ giới hạn các báo cáo từ 15/6/2019 đến 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 sẽ không tải lên báo cáo đó.

Báo cáo đối chiếu được đưa vào phần nội dung của 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 đã mô tả trong 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ụ sau:

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports