Method: accounts.hotelViews.list

Trả về danh sách khung hiển thị khách sạn.

Yêu cầu HTTP

GET https://travelpartner.googleapis.com/v3/{parent=accounts/*}/hotelViews

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Tên tài nguyên của tài khoản đang được truy vấn. Định dạng là accounts/{account_id}.

Tham số truy vấn

Thông số
pageSize

integer

Số lượng phần tử cần truy xuất trong một trang.

pageToken

string

Mã thông báo của trang cần truy xuất.

filter

string

Không bắt buộc. Các điều kiện (trường và biểu thức) dùng để lọc HotelViews. Cú pháp này yêu cầu phải có khoảng trắng xung quanh toán tử in. Nếu không, bạn có thể bỏ qua dấu cách.

Không thể kết hợp các điều kiện.

Bạn có thể sử dụng trường hotelId để chọn các khách sạn cụ thể.

Trường liveOnGoogle có thể chọn những thuộc tính mà Google hiển thị hoặc những thuộc tính bị bỏ qua trong kết quả tìm kiếm trên Google. Giá trị "TRUE" bao gồm những thuộc tính đang hoạt động có điều kiện, ví dụ: LIVE_ON_GOOGLE_STATUS_ACTIVE_OUTSIDE_DSA_REGION.

Bạn có thể dùng trường matchStatus để lọc danh sách HotelViews được trả về cho tài khoản.

Sau đây là ví dụ về các điều kiện hợp lệ và cú pháp của các điều kiện đó:

  • hotelId = 'hotel_ABC'
  • hotelId in ('hotel_ABC', 'hotel_XYZ')
  • liveOnGoogle = 'TRUE'
  • liveOnGoogle = 'FALSE'
  • matchStatus = 'NOT_MATCHED'
  • matchStatus in ('NOT_MATCHED', 'MATCHED', 'MAP_OVERLAP')

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

Thông báo phản hồi cho HotelViewService.ListHotelViews.

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:

Biểu diễn dưới dạng JSON
{
  "hotelViews": [
    {
      object (HotelView)
    }
  ],
  "nextPageToken": string
}
Trường
hotelViews[]

object (HotelView)

Danh sách các hàng khớp với truy vấn.

nextPageToken

string

Mã thông báo phân trang dùng để truy xuất trang kết quả tiếp theo.

Phạm vi uỷ quyền

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 OAuth 2.0 Overview.