- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi cấp phép
- Kết quả đặt trước liên kết miễn phí
KHÔNG DÙNG HOẠT ĐỘNG: Sử dụng PropertyPerformanceReportService.QueryPropertyPerformanceReport
cũng có báo cáo hiển thị. Hỗ trợ truy vấn (nhận, lọc và phân đoạn) một báo cáo về đường liên kết miễn phí để đặt phòng của một tài khoản cụ thể.
Yêu cầu HTTP
GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/freeBookingLinksReportViews:query
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
name |
Tên tài nguyên của tài khoản đang được truy vấn. Định dạng: accounts/{account_id} |
Tham số truy vấn
Các tham số | |
---|---|
filter |
Các điều kiện (trường và biểu thức) dùng để lọc chỉ số đường liên kết miễn phí để đặt phòng cho tài khoản đang được truy vấn. Cú pháp này yêu cầu khoảng trắng xung quanh toán tử Trường Các giá trị của trường Các giá trị cho Ví dụ về các điều kiện hợp lệ như sau:
|
aggregateBy |
Chỉ định cách phân đoạn các chỉ số mà truy vấn trả về. Ví dụ: nếu bạn chỉ định Giá trị chuỗi là một danh sách các trường được phân tách bằng dấu phẩy. Các trường hợp lệ là: |
pageSize |
Số lượng kết quả tham gia tối đa được trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, tối đa 10.000 kết quả sẽ được trả về. Giá trị tối đa là 10.000; các giá trị trên 10.000 sẽ bị ép buộc thành 10.000. |
pageToken |
Mã thông báo trang, nhận được từ yêu cầu engagementReportView.query trước đó. Cung cấp mã này để nhận trang tiếp theo. Khi phân trang, tất cả các thông số khác được cung cấp cho engagementReportViews.query phải khớp với lệnh gọi đã cung cấp mã thông báo trang. |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Ngừng sử dụng: Sử dụng QueryPropertyPerformanceReportResponse
với PropertyPerformanceReportService
. Thông báo phản hồi cho FreeBookingLinksReportService.QueryFreeBookingLinksReport
.
Biểu diễn dưới dạng JSON |
---|
{
"results": [
{
object ( |
Các trường | |
---|---|
results[] |
Danh sách kết quả phù hợp với truy vấn. |
nextPageToken |
Mã phân trang được dùng để truy xuất trang kết quả tiếp theo. Nếu trường này bị bỏ qua, thì sẽ không có trang nào tiếp theo. |
Phạm vi cấp phép
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/travelpartner
Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
Kết quả đặt trước liên kết miễn phí
Ngừng sử dụng: Sử dụng PropertyPerformanceResult
với PropertyPerformanceReportService
. Đại diện cho kết quả khi truy vấn các số liệu thống kê về đường liên kết miễn phí để đặt phòng của một tài khoản.
Biểu diễn dưới dạng JSON |
---|
{ "date": { object ( |
Các trường | |
---|---|
date |
Một ngày trong phạm vi ngày được yêu cầu. Chỉ xuất hiện nếu |
userRegionCode |
Mã vùng ISO 3116 của quốc gia/khu vực của người dùng. Chỉ hiển thị nếu |
deviceType |
Loại thiết bị của người dùng. Chỉ xuất hiện nếu |
partnerHotelId |
Mã khách sạn của đối tác. Chỉ xuất hiện nếu |
partnerHotelDisplayName |
Tên khách sạn của đối tác. Chỉ xuất hiện nếu |
clickCount |
Tổng số lượt nhấp được ghi lại cho kết quả này. |