Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Method: accounts.propertyPerformanceReportViews.query

HTTP 요청
경로 파라미터
쿼리 파라미터
요청 본문
응답 본문
- JSON 표현
승인 범위
PropertyPerformanceResult
- JSON 표현
AdvanceBookingWindow
LengthOfStay
숙박 인원

특정 계정의 무료 예약 링크 보고서를 쿼리 (가져오기, 필터링, 분류)할 수 있는 기능을 제공합니다. 이 새로운 버전은 노출수와 클릭수뿐만 아니라 훨씬 더 큰 필터/집계의 상위 집합을 반환합니다.

HTTP 요청

GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/propertyPerformanceReportViews:query

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수

매개변수
`name`	`string` 쿼리되는 계정의 리소스 이름입니다. 형식: accounts/{account_id}

name

string

쿼리되는 계정의 리소스 이름입니다. 형식: accounts/{account_id}

쿼리 매개변수

매개변수
`filter`	`string` 쿼리되는 계정의 속성 실적 측정항목을 필터링하는 데 사용되는 조건 (필드 및 표현식)입니다. 구문에는 `in` 연산자 주변에 공백이 필요합니다. 그렇지 않으면 공백을 생략할 수 있습니다. `AND` 연산자를 사용하여 조건을 결합할 수 있습니다. 중요: 여러 조건을 추가하는 올바른 문법은 `"?filter=<condition>=<value>%20AND%20<condition>=<value>..."`입니다. `date` 필드는 필수 입력란입니다. 다른 입력란은 선택사항입니다. `date` 필드 값은 포함되며 YYYY-MM-DD 형식이어야 합니다. 허용되는 가장 빠른 날짜는 2021-03-09입니다. 이전 날짜 값은 2021-03-09로 변환됩니다. `partnerPropertyDisplayName` 및 `brand` 값은 대소문자를 구분하지 않고 일치합니다. 유효한 조건의 예는 다음과 같습니다. `advanceBookingWindow = 'ADVANCE_BOOKING_WINDOW_SAME_DAY'` `advanceBookingWindow in ('ADVANCE_BOOKING_WINDOW_SAME_DAY', 'ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90')` `brand = 'Brand A'` `brand in ('Brand A', 'brand B')` `date = '2021-12-03'` `date between '2021-12-03' and '2021-12-08'` `deviceType = 'TABLET'` `deviceType in ('MOBILE', 'TABLET')` `highIntentUsers = 'TRUE'` `highIntentUsers = 'FALSE'` `lengthOfStay = 'LENGTH_OF_STAY_NIGHTS_2'` `lengthOfStay in ('LENGTH_OF_STAY_NIGHTS_2', 'LENGTH_OF_STAY_NIGHTS_4_TO_7')` `propertyRegionCode = 'US'` `propertyRegionCode in ('US', 'CA')` `occupancy = 'OCCUPANCY_2'` `occupancy in ('OCCUPANCY_2', 'OCCUPANCY_OVER_4')` `partnerPropertyId = 'AAA'` `partnerPropertyId in ('AAA', 'BBB')` `partnerPropertyDisplayName = 'hotel A'` `partnerPropertyDisplayName in ('Hotel A', 'HOTEL b')` `userRegionCode = 'US'` `userRegionCode in ('US', 'CA')`
`aggregateBy`	`string` 쿼리에서 반환된 측정항목을 분류하는 방법을 지정합니다. 예를 들어 `userRegionCode`이 지정되면 `PropertyPerformanceResult`은 사용자 지역별로 집계된 측정항목을 제공합니다. 문자열 값은 쉼표로 구분된 필드 목록입니다. 유효한 필드는 `advanceBookingWindow`, `brand`, `date`, `deviceType`, `highIntentUsers`, `lengthOfStay`, `propertyRegionCode`, `occupancy`, `partnerPropertyId`, `partnerPropertyDisplayName`, `userRegionCode`입니다. 여기에 지정된 필드만 PropertyPerformanceResult에 포함됩니다. 중요: `partnerHotelId` 또는 두 개 이상의 값과 함께 `aggregateBy` 매개변수를 사용하면 오류가 발생할 수 있습니다. `partnerHotelId` 및 `date`로 필터링하여 행 수를 줄이면 오류 발생을 방지할 수 있습니다.
`pageSize`	`integer` 반환할 참여 결과의 최대 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 10,000개의 결과가 반환됩니다. 최댓값은 10,000이며, 10,000을 초과하는 값은 10,000으로 변환됩니다.
`pageToken`	`string` 이전 participationReportViews.query 요청에서 수신된 페이지 토큰입니다. 후속 페이지를 수신하려면 이를 제공합니다. 페이지로 나누는 경우 participationReportViews.query에 제공하는 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

PropertyPerformanceReportService.QueryPropertyPerformanceReport의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{ "results": [ { object (`PropertyPerformanceResult`) } ], "nextPageToken": string }

필드

필드
`results[]`	`object (PropertyPerformanceResult)` 쿼리와 일치하는 결과 목록입니다.
`nextPageToken`	`string` 결과의 다음 페이지를 가져오는 데 사용되는 페이지로 나누기 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

results[]

object (PropertyPerformanceResult)

쿼리와 일치하는 결과 목록입니다.

nextPageToken

string

결과의 다음 페이지를 가져오는 데 사용되는 페이지로 나누기 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/travelpartner

자세한 내용은 OAuth 2.0 Overview를 참조하세요.

PropertyPerformanceResult

계정의 속성 실적 보고서를 쿼리한 결과를 나타냅니다.

JSON 표현

JSON 표현
{ "date": { object (`Date`) }, "advanceBookingWindow": enum (`AdvanceBookingWindow`), "brand": string, "deviceType": enum (`Device`), "highIntentUsers": boolean, "lengthOfStay": enum (`LengthOfStay`), "propertyRegionCode": string, "occupancy": enum (`Occupancy`), "partnerPropertyId": string, "partnerPropertyDisplayName": string, "userRegionCode": string, "clickCount": string, "impressionCount": string, "clickthroughRate": number, "adsClickCount": string, "adsImpressionCount": string, "adsClickthroughRate": number, "vrWebsiteButtonClicks": string }

{
  "date": {
    object (Date)
  },
  "advanceBookingWindow": enum (AdvanceBookingWindow),
  "brand": string,
  "deviceType": enum (Device),
  "highIntentUsers": boolean,
  "lengthOfStay": enum (LengthOfStay),
  "propertyRegionCode": string,
  "occupancy": enum (Occupancy),
  "partnerPropertyId": string,
  "partnerPropertyDisplayName": string,
  "userRegionCode": string,
  "clickCount": string,
  "impressionCount": string,
  "clickthroughRate": number,
  "adsClickCount": string,
  "adsImpressionCount": string,
  "adsClickthroughRate": number,
  "vrWebsiteButtonClicks": string
}

필드
`date`	`object (Date)` 요청된 기간 내의 날짜입니다. 요청의 `aggregateBy`에 `date`가 지정된 경우에만 존재합니다.
`advanceBookingWindow`	`enum (AdvanceBookingWindow)` 속성의 현지 시간대에서 검색 날짜와 체크인 날짜 간의 일수 차이입니다. 요청의 `aggregateBy`에 `advanceBookingWindow`가 지정된 경우에만 존재합니다.
`brand`	`string` 숙박 시설에 대해 파트너가 지정한 브랜드입니다. 요청의 `aggregateBy`에 `brand`가 지정된 경우에만 존재합니다.
`deviceType`	`enum (Device)` 사용자의 기기 유형입니다. 요청의 `aggregateBy`에 `deviceType`가 지정된 경우에만 존재합니다.
`highIntentUsers`	`boolean` 사용자의 쿼리에서 예약할 의향이 높은 것으로 나타났는지 여부입니다. 요청의 `aggregateBy`에 `highIntentUsers`가 지정된 경우에만 존재합니다.
`lengthOfStay`	`enum (LengthOfStay)` 사용자가 지정한 체크인 날짜와 체크아웃 날짜 사이의 숙박 일수입니다. 요청의 `aggregateBy`에 `lengthOfStay`가 지정된 경우에만 존재합니다.
`propertyRegionCode`	`string` 숙박 시설의 국가/지역의 ISO 3116 지역 코드입니다. 요청의 `aggregateBy`에 `propertyRegionCode`가 지정된 경우에만 존재합니다.
`occupancy`	`enum (Occupancy)` 숙박을 요청한 인원수입니다. 요청의 `aggregateBy`에 `partnerPropertyId`가 지정된 경우에만 존재합니다.
`partnerPropertyId`	`string` 파트너의 숙박 시설 ID입니다. 요청의 `aggregateBy`에 `partnerPropertyId`가 지정된 경우에만 존재합니다.
`partnerPropertyDisplayName`	`string` 파트너의 속성 이름입니다. 요청의 `aggregateBy`에 `partnerPropertyDisplayName`가 지정된 경우에만 존재합니다.
`userRegionCode`	`string` 사용자의 국가/지역의 ISO 3116 지역 코드입니다. 요청의 `aggregateBy`에 `userRegionCode`가 지정된 경우에만 존재합니다.
`clickCount`	`string (int64 format)` 이 결과에 대해 기록된 무료 예약 링크 클릭수의 총계입니다.
`impressionCount`	`string (int64 format)` 이 결과에 대해 기록된 무료 예약 링크 노출수의 총수입니다. 이 값은 사용자 개인 정보 보호를 위해 반올림됩니다.
`clickthroughRate`	`number` `clickCount`을 `impressionCount`로 나눈 값과 같습니다.
`adsClickCount`	`string (int64 format)` 이 결과에 대해 기록된 총 광고 클릭수입니다.
`adsImpressionCount`	`string (int64 format)` 이 결과에 대해 기록된 총 광고 노출수입니다.
`adsClickthroughRate`	`number` `adsClickCount`을 `adsImpressionCount`로 나눈 값과 같습니다.
`vrWebsiteButtonClicks`	`string (int64 format)` Google에서 공유숙박의 '웹사이트' 버튼을 클릭한 총수입니다.

AdvanceBookingWindow

지원되는 사전 예약 가능 기간 (ABW)을 열거합니다. 모든 날짜 비교는 속성의 시간대를 기준으로 합니다.

열거형
`ADVANCE_BOOKING_WINDOW_UNSPECIFIED`	지정되지 않음
`ADVANCE_BOOKING_WINDOW_SAME_DAY`	체크인 날짜가 검색 날짜와 동일했습니다.
`ADVANCE_BOOKING_WINDOW_NEXT_DAY`	체크인 날짜가 쿼리 날짜 다음 날이었습니다.
`ADVANCE_BOOKING_WINDOW_DAYS_2_TO_7`	체크인 날짜가 검색 날짜로부터 2~7일 후였습니다.
`ADVANCE_BOOKING_WINDOW_DAYS_8_TO_14`	체크인 날짜가 검색 날짜로부터 8~14일 후였습니다.
`ADVANCE_BOOKING_WINDOW_DAYS_15_TO_30`	체크인 날짜가 문의 날짜로부터 15~30일 후였습니다.
`ADVANCE_BOOKING_WINDOW_DAYS_31_TO_60`	체크인 날짜가 문의 날짜로부터 31~60일 후입니다.
`ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90`	체크인 날짜가 문의 날짜로부터 61~90일 후입니다.
`ADVANCE_BOOKING_WINDOW_DAYS_91_TO_120`	체크인 날짜가 문의 날짜로부터 91~120일 후입니다.
`ADVANCE_BOOKING_WINDOW_DAYS_121_TO_150`	체크인 날짜가 문의 날짜로부터 121~150일 후입니다.
`ADVANCE_BOOKING_WINDOW_DAYS_151_TO_180`	체크인 날짜가 문의 날짜로부터 151~180일 후입니다.
`ADVANCE_BOOKING_WINDOW_DAYS_OVER_180`	체크인 날짜가 검색 날짜로부터 180일이 지났습니다.

LengthOfStay

지원되는 숙박 기간 (LOS)을 열거합니다.

열거형
`LENGTH_OF_STAY_UNSPECIFIED`	지정되지 않음
`LENGTH_OF_STAY_NIGHTS_1`	1박 숙박
`LENGTH_OF_STAY_NIGHTS_2`	2박 숙박
`LENGTH_OF_STAY_NIGHTS_3`	3박 숙박
`LENGTH_OF_STAY_NIGHTS_4_TO_7`	4~7박 숙박
`LENGTH_OF_STAY_NIGHTS_8_TO_14`	8~14박 숙박
`LENGTH_OF_STAY_NIGHTS_15_TO_21`	15~21박 숙박
`LENGTH_OF_STAY_NIGHTS_22_TO_30`	22~30박 숙박
`LENGTH_OF_STAY_NIGHTS_OVER_30`	30박 초과 숙박

숙박 인원

지원되는 총 회의실 점유율을 열거합니다.

열거형
`OCCUPANCY_UNSPECIFIED`	지정되지 않음
`OCCUPANCY_1`	한 명의 사람
`OCCUPANCY_2`	2인 요금제.
`OCCUPANCY_3`	3명
`OCCUPANCY_4`	4명
`OCCUPANCY_OVER_4`	4명 이상

Method: accounts.propertyPerformanceReportViews.query 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.