Method: accounts.freeBookingLinksReportViews.query

KHÔNG DÙNG NỮA: Thay vào đó, hãy sử dụng PropertyPerformanceReportService.QueryPropertyPerformanceReport. Lớp này cũng có tính năng báo cáo lượt hiển thị. Cho phép truy vấn (nhận, lọc và phân đoạn) báo cáo đường liên kết đặt phòng miễn phí cho 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

Thông số
name

string

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

Thông số
filter

string

Các điều kiện (trường và biểu thức) được dùng để lọc các chỉ số của đường liên kết đặt phòng miễn phí cho tài khoản đang được truy vấn. 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. Bạn có thể kết hợp các điều kiện bằng toán tử and.

Bạn bắt buộc phải điền vào trường date. Tất cả các trường khác đều không bắt buộc.

Các giá trị trường date là giá trị bao gồm và phải ở định dạng YYYY-MM-DD. Ngày sớm nhất có thể chấp nhận là 2021-03-09; các giá trị ngày trước đó sẽ được chuyển đổi thành 2021-03-09.

Các giá trị cho partnerHotelDisplayName được so khớp mà không phân biệt chữ hoa chữ thường.

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

  • date = '2021-12-03'
  • date between '2021-12-03' and '2021-12-08'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • partnerHotelDisplayName = 'hotel A'
  • partnerHotelDisplayName in ('Hotel A', 'HOTEL b')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

Chỉ định cách phân đoạn các chỉ số do truy vấn trả về. Ví dụ: nếu bạn chỉ định userRegionCode, thì freeBookingLinksResult sẽ cung cấp các chỉ số được tổng hợp theo khu vực của người dùng.

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à: date, userRegionCode, deviceType, partnerHotelId và partnerHotelDisplayName. Chỉ những trường được chỉ định ở đây mới được đưa vào FreeBookingLinksResult.
pageSize

integer

Số lượng kết quả tham gia tối đa cần 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ị lớn hơn 10.000 sẽ được ép buộc thành 10.000.
pageToken

string

Mã thông báo trang nhận được từ yêu cầu participationReportViews.query trước đó. Cung cấp thông tin này để nhận trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho participationReportViews.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

KHÔNG DÙNG NỮA: Hãy dùng QueryPropertyPerformanceReportResponse với PropertyPerformanceReportService. Thông báo phản hồi cho FreeBookingLinksReportService.QueryFreeBookingLinksReport.

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 
{
  "results": [
    {
      object (FreeBookingLinksResult)
    }
  ],
  "nextPageToken": string
}
Trường
results[]

object (FreeBookingLinksResult)

Danh sách kết quả 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. Nếu bạn bỏ qua trường này, thì sẽ không có các trang 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.

FreeBookingLinksResult

KHÔNG DÙNG NỮA: Hãy dùng PropertyPerformanceResult với PropertyPerformanceReportService. Biểu thị kết quả từ việc truy vấn số liệu thống kê về đường liên kết miễn phí để đặt phòng cho một tài khoản.

Biểu diễn dưới dạng JSON 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "partnerHotelDisplayName": string,
  "clickCount": string
}
Trường
date

object (Date)

Một ngày trong phạm vi ngày được yêu cầu.

Chỉ xuất hiện nếu date được chỉ định trong aggregateBy trong yêu cầu.
userRegionCode

string

Mã khu vực ISO 3116 của quốc gia/khu vực nơi người dùng sinh sống.

Chỉ xuất hiện nếu userRegionCode được chỉ định trong aggregateBy trong yêu cầu
deviceType

enum (Device)

Loại thiết bị của người dùng.

Chỉ xuất hiện nếu deviceType được chỉ định trong aggregateBy trong yêu cầu.
partnerHotelId

string

Mã khách sạn của đối tác.

Chỉ xuất hiện nếu partnerHotelId được chỉ định trong aggregateBy trong yêu cầu.
partnerHotelDisplayName

string

Tên khách sạn của đối tác.

Chỉ xuất hiện nếu partnerHotelDisplayName được chỉ định trong aggregateBy trong yêu cầu.
clickCount

string (int64 format)

Tổng số lượt nhấp được ghi nhận cho kết quả này.