Method: accounts.participationReportViews.query

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

Yêu cầu HTTP

GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/participationReportViews: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 là 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) dùng để lọc các chỉ số về mức độ tham gia 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.

Lưu ý quan trọng: Cú pháp chính xác để thêm nhiều điều kiện là: "?filter=<condition>=<value>%20AND%20<condition>=<value>..."

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.

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

  • advanceBookingWindow = 2
  • advanceBookingWindow >= 0
  • advanceBookingWindow <= 5
  • checkinDate = '2020-10-01'
  • checkinDate >= '2020-10-01'
  • checkinDate <= '2020-10-01'
  • checkinDate between '2020-10-01' and '2020-10-05'
  • date = '2020-02-04'
  • date between '2020-02-04' and '2020-02-09'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • hotelRegionCode = 'US'
  • hotelRegionCode in ('US', 'CA')
  • lengthOfStayDays = 2
  • lengthOfStayDays >= 0
  • lengthOfStayDays <= 5
  • occupancy = 2
  • occupancy >= 0
  • occupancy <= 5
  • occupancy between 1 and 5
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • 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 userRegionCode được chỉ định làm giá trị aggregateBy, thì participationResult 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, hotelRegionCode, advanceBookingWindow, lengthOfStayDays, checkinDate và occupancy. Những trường không được chỉ định sẽ không có trong ParticipationResult.

Lưu ý quan trọng: Việc sử dụng tham số aggregateBy với partnerHotelId hoặc nhiều hơn 2 giá trị có thể dẫn đến lỗi. Việc lọc bằng partnerHotelId và date để giảm số lượng hàng có thể ngăn chặn lỗi xảy ra.
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

Thông báo phản hồi cho ParticipationReportService.QueryParticipationReport.

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

object (ParticipationResult)

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.

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.

ParticipationResult

Biểu thị kết quả từ việc truy vấn số liệu thống kê về hoạt động tham gia của một tài khoản.

Biểu diễn dưới dạng JSON 
{
  "key": {
    object (Key)
  },
  "opportunityCount": string,
  "participationCount": string,
  "participationPercent": number,
  "missedParticipationCount": string,
  "missedParticipationCountDetails": {
    object (MissedParticipationCountDetails)
  },
  "partnerHotelDisplayName": string
}
Trường
key

object (Key)

Khoá của kết quả.
opportunityCount

string (int64 format)

Đối với một khách sạn cụ thể, đây là tổng số cơ hội đã có. Cơ hội là tổng số lần mà một quảng cáo khách sạn đã có thể tiếp cận được người dùng.
participationCount

string (int64 format)

Tổng số cơ hội khi bạn đủ điều kiện tham gia quá trình đấu giá trên Google Ads.
participationPercent

number

Tỷ lệ phần trăm nắm được cơ hội đấu giá, tức là lấy số cơ hội mà bạn đã tham gia thành công chia cho tổng số cơ hội. Ví dụ: nếu một cơ sở lưu trú đủ điều kiện tham gia phiên đấu giá quảng cáo trên Google Ads 90 lần trong số 100 cơ hội, thì tỷ lệ được tham gia đấu giá là 90%.
missedParticipationCount

string (int64 format)

Tổng số cơ hội không đủ điều kiện tham gia quy trình đấu giá trên Google Ads. Bao gồm những trường hợp sau:

  • Thiếu trang đích
  • Thiếu giá
  • Có vấn đề về giá
  • Chưa có giá
  • Khác
missedParticipationCountDetails

object (MissedParticipationCountDetails)

Những lý do dẫn đến số lượt tham gia bị bỏ lỡ (ví dụ: không có phòng) và tổng số lượt tham gia bị bỏ lỡ cho từng lý do.
partnerHotelDisplayName

string

Tên hiển thị khách sạn của đối tác. Trường này chỉ được điền khi kết quả được tổng hợp theo partnerHotelId.

Khoá

Khoá của một kết quả.

Biểu diễn dưới dạng JSON 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "hotelRegionCode": string,
  "advanceBookingWindow": integer,
  "lengthOfStayDays": integer,
  "checkinDate": {
    object (Date)
  },
  "occupancy": integer
}
Trường
date

object (Date)

Ngày mà bạn đang yêu cầu chỉ số.

Nếu date không phải là giá trị của tham số aggregateBy trong lệnh gọi yêu cầu, thì trường date sẽ không được trả về trong Key.
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.

Nếu userRegionCode không phải là giá trị của tham số aggregateBy trong lệnh gọi yêu cầu, thì trường userRegionCode sẽ không được trả về trong Key.
deviceType

enum (Device)

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

Nếu deviceType không phải là giá trị của tham số aggregateBy trong lệnh gọi yêu cầu, thì trường deviceType sẽ không được trả về trong Key.
partnerHotelId

string

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

Nếu partnerHotelId không phải là giá trị của tham số aggregateBy trong lệnh gọi yêu cầu, thì trường partnerHotelId sẽ không được trả về trong Key.
hotelRegionCode

string

Mã vùng CLDR của quốc gia/khu vực nơi khách sạn đặt tại.

Nếu hotelRegionCode không phải là giá trị của tham số aggregateBy trong lệnh gọi yêu cầu, thì trường hotelRegionCode sẽ không được trả về trong Key.
advanceBookingWindow

integer

Số ngày mà người dùng muốn đặt trước hành trình.

Nếu advanceBookingWindow không phải là giá trị của tham số aggregateBy trong lệnh gọi yêu cầu, thì trường advanceBookingWindow sẽ không được trả về trong Key.
lengthOfStayDays

integer

Số đêm của hành trình.

Nếu lengthOfStayDays không phải là giá trị của tham số aggregateBy trong lệnh gọi yêu cầu, thì trường lengthOfStayDays sẽ không được trả về trong Key.
checkinDate

object (Date)

Ngày nhận phòng của hành trình.

Nếu checkinDate không phải là giá trị của tham số aggregateBy trong lệnh gọi yêu cầu, thì trường checkinDate sẽ không được trả về trong Key.
occupancy

integer

Tổng số người trong hành trình.

Nếu occupancy không phải là giá trị của tham số aggregateBy trong lệnh gọi yêu cầu, thì trường occupancy sẽ không được trả về trong Key.

MissedParticipationCountDetails

Số cơ hội đấu giá bị bỏ lỡ được phân tích theo lý do.

Biểu diễn dưới dạng JSON 
{
  "noAvailabilityCount": string,
  "hotelSuspendedCount": string,
  "noTaxBreakdownCount": string,
  "noLandingPageCount": string,
  "noPriceCount": string,
  "noPriceCountDetails": {
    object (NoPriceCountDetails)
  },
  "otherReasonCount": string,
  "priceMissingCount": string,
  "priceMissingCountDetails": {
    object (PriceMissingCountDetails)
  },
  "priceProblemCount": string,
  "priceProblemCountDetails": {
    object (PriceProblemCountDetails)
  },
  "priceUnavailableCount": string,
  "priceUnavailableCountDetails": {
    object (PriceUnavailableCountDetails)
  }
}
Trường
noAvailabilityCount
(deprecated)

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do không có tổ hợp khách sạn/hành trình hoặc khách du lịch không đủ điều kiện hưởng mức giá được đưa ra. Để tham gia các phiên đấu giá này, có thể bạn cần phải cung cấp thêm thông tin về giá.
hotelSuspendedCount
(deprecated)

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do một hoặc nhiều khách sạn của bạn bị tạm ngưng do vi phạm độ chính xác về giá.
noTaxBreakdownCount
(deprecated)

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do một hoặc nhiều khách sạn của bạn không xác định cụ thể các khoản thuế và phí.
noLandingPageCount

string (int64 format)

Không có trang đích nào phù hợp với người dùng.
noPriceCount
(deprecated)

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do không có giá cho hành trình được yêu cầu.
noPriceCountDetails
(deprecated)

object (NoPriceCountDetails)

Những lý do dẫn đến số lượng không có giá (ví dụ: chế độ cung cấp mức giá hiện tại không hoạt động) và tổng số lượng cho từng lý do.
otherReasonCount

string (int64 format)

Khách sạn không tham gia vì lý do không xác định.
priceMissingCount

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do giá không có trong bộ nhớ đệm của Google hoặc do không phản hồi được chế độ cung cấp mức giá hiện tại. Bao gồm những trường hợp sau:

  • Hết băng thông
  • Thiếu giá trong bộ nhớ đệm
  • Hành trình bị chặn
  • Chưa thiết lập chế độ cung cấp mức giá hiện tại
  • Hết thời gian chờ của chế độ cung cấp mức giá hiện tại
  • Lỗi về chế độ cung cấp mức giá hiện tại
priceMissingCountDetails

object (PriceMissingCountDetails)

Những lý do góp phần làm tăng số lượng giá bị thiếu.
priceProblemCount

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do có vấn đề về độ chính xác của giá mà bạn cung cấp cho hành trình. Bao gồm những trường hợp sau:

  • Khách sạn bị tạm ngưng hoạt động
  • Giá cao bất thường
  • Giá thấp bất thường
  • Thiếu thuế và phí
priceProblemCountDetails

object (PriceProblemCountDetails)

Những lý do dẫn đến số lượng vấn đề về giá.
priceUnavailableCount

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do không có giá niêm yết (-1) cho hành trình được yêu cầu. Bao gồm những trường hợp sau:

  • Chưa có giá
  • Không có nhiều khả năng được tham gia đấu giá
  • Khác
priceUnavailableCountDetails

object (PriceUnavailableCountDetails)

Những lý do dẫn đến số lượng sản phẩm không có giá.

NoPriceCountDetails

Những lý do dẫn đến số lượng không có giá và tổng số lượng cho từng lý do.

Biểu diễn dưới dạng JSON 
{
  "livePricingTechnicalIssueCount": string,
  "livePricingNotTriggeredCount": string,
  "livePricingConfigIssueCount": string,
  "livePricingNotAvailableCount": string,
  "livePricingOtherReasonCount": string
}
Trường
livePricingTechnicalIssueCount

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do các vấn đề kỹ thuật về chế độ cung cấp mức giá hiện tại vì bất kỳ lý do nào sau đây:

  • Bạn không phản hồi kịp thời và vượt quá thời hạn phản hồi (khoảng 4000 mili giây).
  • Bạn trả về một lỗi.
  • Phản hồi của bạn không đúng định dạng.
livePricingNotTriggeredCount

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do chế độ cung cấp mức giá hiện tại không được kích hoạt vì bất kỳ lý do nào sau đây:

  • Bạn chưa đặt giá thầu.
  • Bạn chưa có trang đích hợp lệ.
  • Không có đủ giá trong bộ nhớ đệm.
livePricingConfigIssueCount

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do chế độ cung cấp mức giá hiện tại không được kích hoạt vì bất kỳ lý do nào sau đây:

  • Bạn chưa thiết lập chế độ cung cấp mức giá hiện tại cho những lượt tìm kiếm này.
  • Bạn đã hạn chế quyền truy cập của Google vào hành trình có liên quan của khách sạn.
livePricingNotAvailableCount

string (int64 format)

Tổng số cơ hội đấu giá bị bỏ lỡ do không có chế độ cung cấp mức giá hiện tại. Chúng tôi sẽ không kích hoạt chế độ cung cấp mức giá hiện tại đối với một số hành trình hoặc giao diện người dùng mặc định. Trong trường hợp này, đối tác cần phải có giá lưu trong bộ nhớ đệm để tham gia.
livePricingOtherReasonCount

string (int64 format)

Số cơ hội đấu giá bị bỏ lỡ do các vấn đề khác về chế độ cung cấp mức giá hiện tại.

PriceMissingCountDetails

Những lý do dẫn đến số lượng giá bị thiếu và tổng số lượng cho từng lý do.

Biểu diễn dưới dạng JSON 
{
  "cacheRateMissingCount": string,
  "itineraryBlockedCount": string,
  "livePricingNotSetupCount": string,
  "bandwidthDepletedCount": string,
  "livePricingTimeoutCount": string,
  "livePricingErrorCount": string
}
Trường
cacheRateMissingCount

string (int64 format)

Không có giá trong bộ nhớ đệm cho hành trình này. Lượt truy vấn trực tiếp không được thực hiện do các hạn chế của trang.
itineraryBlockedCount

string (int64 format)

Hành trình nằm ngoài các tham số cơ bản của bạn, vì vậy không lấy được giá cho hành trình này bằng cách truy vấn trực tiếp hoặc lưu vào bộ nhớ đệm.
livePricingNotSetupCount

string (int64 format)

Giá không được lưu vào bộ nhớ đệm cho hành trình này và tài khoản này chưa thiết lập chế độ truy vấn trực tiếp.
bandwidthDepletedCount

string (int64 format)

Không có giá nào được lưu vào bộ nhớ đệm cho hành trình này và không còn hạn mức truy vấn trực tiếp.
livePricingTimeoutCount

string (int64 format)

Không có giá nào được lưu vào bộ nhớ đệm cho hành trình này và lượt truy vấn trực tiếp gửi đến hệ thống của bạn đã hết thời gian chờ.
livePricingErrorCount

string (int64 format)

Giá không được lưu vào bộ nhớ đệm cho hành trình này. Lượt truy vấn trực tiếp không hết thời gian chờ nhưng hệ thống trả về lỗi.

PriceProblemCountDetails

Những lý do góp phần vào số lượng vấn đề về giá và tổng số lượng cho từng lý do.

Biểu diễn dưới dạng JSON 
{
  "hotelSuspendedCount": string,
  "priceUnusuallyHighCount": string,
  "priceUnusuallyLowCount": string,
  "taxesAndFeesMissingCount": string,
  "basePriceViolationsCount": string,
  "priceAccuracyIssueCount": string
}
Trường
hotelSuspendedCount

string (int64 format)

Khách sạn bị tạm ngưng hoạt động. Điều này có thể xảy ra do những vấn đề liên tục xảy ra ở những khía cạnh như thuế và phí không chính xác.
priceUnusuallyHighCount

string (int64 format)

Giá cho hành trình này có vẻ cao hơn rất nhiều so với các xu hướng trong khu vực.
priceUnusuallyLowCount

string (int64 format)

Giá cho hành trình này có vẻ thấp hơn rất nhiều so với các xu hướng trong khu vực.
taxesAndFeesMissingCount

string (int64 format)

Thiếu thuế và phí trong giá.
basePriceViolationsCount

string (int64 format)

Giá cơ sở quá thấp so với tổng giá.
priceAccuracyIssueCount

string (int64 format)

Vấn đề về độ chính xác của giá.

PriceUnavailableCountDetails

Những lý do dẫn đến số lượng giá không có sẵn và tổng số lượng cho từng lý do.

Biểu diễn dưới dạng JSON 
{
  "priceUnavailableCount": string,
  "participationNotLikelyCount": string
}
Trường
priceUnavailableCount

string (int64 format)

Khách sạn không tham gia đấu giá vì không có giá cho ngày trong hành trình.
participationNotLikelyCount

string (int64 format)

Không có giá trong bộ nhớ đệm cho hành trình này và không thể truy vấn trực tiếp vì máy chủ của bạn thường thông báo với chúng tôi rằng khách sạn không có phòng hoặc đã hết phòng.