Method: accounts.freeBookingLinksReportViews.query

지원 중단됨: 대신 노출수 보고 기능도 있는 PropertyPerformanceReportService.QueryPropertyPerformanceReport를 사용하세요. 특정 계정의 무료 예약 링크 보고서를 쿼리 (가져오기, 필터링, 분류)할 수 있는 기능을 제공합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
name

string

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

쿼리 매개변수

매개변수
filter

string

쿼리되는 계정의 무료 예약 링크 측정항목을 필터링하는 데 사용되는 조건 (필드 및 표현식)입니다. 구문에는 in 연산자 주변에 공백이 필요합니다. 그렇지 않으면 공백을 생략할 수 있습니다. and 연산자를 사용하여 조건을 결합할 수 있습니다.

date 필드는 필수 입력란입니다. 다른 입력란은 선택사항입니다.

date 필드 값은 포함되며 YYYY-MM-DD 형식이어야 합니다. 허용되는 가장 빠른 날짜는 2021-03-09입니다. 이전 날짜 값은 2021-03-09로 변환됩니다.

partnerHotelDisplayName 값은 대소문자를 구분하지 않고 일치합니다.

유효한 조건의 예는 다음과 같습니다.

  • 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

쿼리에서 반환된 측정항목을 분류하는 방법을 지정합니다. 예를 들어 userRegionCode이 지정되면 freeBookingLinksResult은 사용자 지역별로 집계된 측정항목을 제공합니다.

문자열 값은 쉼표로 구분된 필드 목록입니다. 유효한 필드는 date, userRegionCode, deviceType, partnerHotelId, partnerHotelDisplayName입니다. 여기에 지정된 필드만 FreeBookingLinksResult에 포함됩니다.
pageSize

integer

반환할 참여 결과의 최대 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 지정하지 않으면 최대 10,000개의 결과가 반환됩니다. 최댓값은 10,000이며, 10,000을 초과하는 값은 10,000으로 변환됩니다.
pageToken

string

이전 participationReportViews.query 요청에서 수신된 페이지 토큰입니다. 후속 페이지를 수신하려면 이를 제공합니다.

페이지로 나누는 경우 participationReportViews.query에 제공하는 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.

요청 본문

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

응답 본문

지원 중단됨: 대신 PropertyPerformanceReportService와 함께 QueryPropertyPerformanceReportResponse를 사용하세요. FreeBookingLinksReportService.QueryFreeBookingLinksReport의 응답 메시지입니다.

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

JSON 표현 
{
  "results": [
    {
      object (FreeBookingLinksResult)
    }
  ],
  "nextPageToken": string
}
필드
results[]

object (FreeBookingLinksResult)

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

string

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

승인 범위

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

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

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

FreeBookingLinksResult

지원 중단됨: 대신 PropertyPerformanceReportService와 함께 PropertyPerformanceResult를 사용하세요. 계정의 무료 예약 링크 통계를 쿼리한 결과를 나타냅니다.

JSON 표현 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "partnerHotelDisplayName": string,
  "clickCount": string
}
필드
date

object (Date)

요청된 기간 내의 날짜입니다.

요청의 aggregateBy에 date가 지정된 경우에만 존재합니다.
userRegionCode

string

사용자의 국가/지역의 ISO 3116 지역 코드입니다.

요청의 aggregateBy에 userRegionCode가 지정된 경우에만 존재합니다.
deviceType

enum (Device)

사용자의 기기 유형입니다.

요청의 aggregateBy에 deviceType가 지정된 경우에만 존재합니다.
partnerHotelId

string

파트너의 호텔 ID입니다.

요청의 aggregateBy에 partnerHotelId가 지정된 경우에만 존재합니다.
partnerHotelDisplayName

string

파트너의 호텔 이름입니다.

요청의 aggregateBy에 partnerHotelDisplayName가 지정된 경우에만 존재합니다.
clickCount

string (int64 format)

이 결과에 대해 기록된 총 클릭수입니다.