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
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
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
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
Phản hồi mẫu
{
"contents": "Hotel ID,Hotel Name,Hotel Address,Hotel City,Hotel State/Region,Hotel PostalCode,Hotel Country Code,Hotel Phone Number,Booking Reference,Booking Date and Time,Check-in Date,Check-out Date,Number of Rooms,Number of Guests,Booking Revenue,Booking Revenue Currency,Booking Revenue Currency to Billing Currency Conversion Rate,Booking Status,Commission,Commission Currency,Commission Currency to Billing Currency Conversion Rate,Payment Date,Payment Status\n\n111,\"Capybara Hotel and Spa\",123 Foo Driveway,Boston,MA,02472,US,+11234567890,2thHRTY,2016-01-04,2016-02-01,2016-02-03,1,4,213.88,USD,1,Stayed,21.39,USD,1.0,2016-06-07,Invoice Required\n\n211,\"Mabels Gabels\",45678 Bar Street,London,,KT13 0PU,GB,+440203456123,z452121A,2016-02-04,2016-02-01,2016-02-03,1,3,414.21,GBP,1.249,Stayed,64.43,USD,1.0,2016-06-07,Invoice Required\n\n311,\"No-Tell Motels\",66 Acacia Avenue,Geneva,,1211,CH,+412241820000,42,2016-03-04,2016-02-01,2016-02-03,1,2,451.15,CHF,1.05,Stayed,37.41,EUR,0.99889,2016-06-07,Invoice Required"
}
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
Phản hồi mẫu thành công
{
"successfulRecordCount": 3
}
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
Mọi quyền được bảo lưu. Java là một nhãn hiệu đã đăng ký của Oracle và/hoặc chi nhánh của Oracle.
Cập nhật lần gần đây nhất: 2022-08-23 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2022-08-23 UTC."],[[["The Travel Partner API uses REST-ful syntax for HTTPS calls to various endpoints, allowing access to data like property performance, hotel details, and price accuracy."],["You can query reports, like the Property Performance Report or the Participation Report, to gain insights into your hotel data using specific filters and aggregations."],["The API provides methods for retrieving hotel lists, summaries, price coverage information, and pricing data for individual properties within your account."],["Reconciliation Reports, specifically for Hotel Ads, can be listed, downloaded, validated, and uploaded through dedicated API endpoints."],["The base URL for all API requests is `https://travelpartner.googleapis.com/v3/accounts/account_id`, and detailed documentation for resources is available in the API resources catalog."]]],[]]
