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

이전 engagementReportViews.query 요청에서 받은 페이지 토큰입니다. 후속 페이지를 받으려면 이 값을 입력합니다.

페이지로 나누기를 수행할 때 engagementReportViews.query에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

요청 본문

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

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

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

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

object (FreeBookingLinksResult)

쿼리와 일치하는 결과 목록
nextPageToken

string

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

승인 범위

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

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

Free예약 링크 검색결과

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

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)

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