Usage

이 페이지에서는 Travel Partner API v3를 사용하는 몇 가지 샘플 호출을 보여줍니다.

여행 파트너 API 엔드포인트는 HTTPS 호출에서 RESTful 구문을 허용합니다. 모든 API 요청의 base_url는 다음과 같습니다.

https://travelpartner.googleapis.com/v3/accounts/account_id

요청 및 응답 필드의 전체 목록은 API 리소스 카탈로그를 확인하세요.

숙박 시설 실적 보고서

속성 실적 보고서 보기 서비스를 사용하면 특정 계정의 속성 실적 보고서를 쿼리 (가져오기, 필터링, 세분화)할 수 있습니다.

속성 실적 보고서 쿼리

다음 예에서는 2022년 5월 11일로 필터링되고 파트너 호텔 ID로 그룹화된 계정 12345678의 모든 숙박 시설에 대한 숙박 시설 실적 보고서를 가져옵니다.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/propertyPerformanceReportViews:query?filter=date%20%3D%20%272022-05-11%27&aggregateBy=partnerPropertyId

호텔

호텔 보기 서비스는 특정 계정의 모든 호텔 목록 또는 요약을 제공합니다.

호텔 목록 가져오기

다음 예에서는 계정 12345678의 모든 호텔 목록을 가져옵니다.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews

요청은 다중 페이지 결과를 탐색하기 위한 쿼리 매개변수를 허용합니다.

GET base_url/hotelViews?pageSize=10&pageToken=11

속성 요약 가져오기

이 예에서는 12345678 계정의 속성 요약을 가져옵니다.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/hotelViews:summarize

참여 보고서

참여 보고서 보기 서비스는 특정 계정의 참여 보고서를 쿼리 (가져오기, 필터링, 분류)하는 기능을 제공합니다.

참여 보고서 쿼리

다음 예에서는 계정 12345678의 모든 속성에 대한 참여 보고서를 가져오고 2020년 10월 4일 날짜를 사용하여 보고서를 필터링합니다.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/participationReportViews:query?filter=date%20%3D%20%272020-10-04%27

요금 정확성

가격 정확도 조회 서비스를 사용하면 특정 계정의 가격 정확도 보고서와 스코어카드를 검색할 수 있습니다.

가격 정확성 보고서 받기

다음 예시에서는 2019년 8월 26일에 계정 12345678의 가격 정확도 보고서를 가져옵니다.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews/20190826

응답을 페이지로 나누기 위한 일반적인 쿼리 매개변수 외에도 일치하는 가격이나 픽셀 신호를 결과에 포함하기 위한 매개변수가 몇 개 더 있습니다.

이 예에서 2019년 8월 26일의 가격 정확도 보고서에는 일치하는 가격과 픽셀 신호가 포함되어 있습니다.

GET base_url/priceAccuracyViews/20190826?includeMatchedPrices=true&includePixels=true

사용 가능한 가격 정확성 보고서 나열

사용 가능한 보고서 목록을 가져오려면 다음 요청을 전송하세요.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews

결과를 페이지로 나누기 위해 일반적인 쿼리 매개변수를 포함할 수 있습니다.

가격 정확성 점수 확인하기

가격 정확성 스코어카드를 가져오려면 summarize 메서드를 사용하세요.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceAccuracyViews:summarize

가격 범위

가격 범위 조회 서비스는 최신 가격 범위 보고서 또는 전체 가격 범위 기록을 제공합니다.

최신 가격 범위 통계 가져오기

다음 예에서는 12345678 계정의 최신 가격 적용 범위 통계를 가져옵니다.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews:latest

가격 범위 기록 가져오기

이 요청은 계정의 전체 가격 보장 기록을 가져옵니다.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceCoverageViews

가격

가격 조회 서비스를 사용하면 특정 숙박 시설의 가격 보고서를 가져올 수 있습니다.

숙박 시설의 가격 데이터 가져오기

계정 12345678에 속한 특정 호텔 (ID=101)의 가격 보고서를 가져오려면 다음 요청을 실행하세요.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/priceViews/101

조정 보고서

조정 보고서 서비스를 사용하면 보고서 목록을 가져오고, 특정 보고서를 다운로드하고, 보고서를 검증한 다음, Google에 보고서를 업로드할 수 있습니다.

조정 보고서 목록 가져오기

다음 예시에서는 계정 12345678의 보고서 목록을 가져옵니다.

GET https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports

선택사항인 시작일 및 종료일 쿼리 매개변수를 포함하여 결과를 제한할 수 있습니다. 예를 들어 다음 쿼리는 2019년 6월 15일부터 2019년 9월 15일 사이의 보고서만 표시합니다.

GET base_url/reconciliationReports?startDate=2019-06-15&endDate=2019-09-15

조정 보고서 다운로드

이 예에서는 2019-08-26T12:00:00에 업로드된 booking_report.csv 보고서를 JSON 응답으로 가져옵니다.

GET base_url/reconciliationReports/2019-08-26T12%3A00%3A00~bookings.csv

조정 보고서 유효성 검사하기

이 방법을 사용하여 보고서를 업로드하기 전에 유효성을 검사할 수 있습니다. 보고서를 검증해도 보고서가 업로드되지는 않습니다.

조정 보고서는 요청 본문에 contents 필드의 값으로 포함됩니다. 조정 보고서는 조정 보고서에 설명된 구문을 따라야 합니다.

다음 예시에서는 계정 12345678의 보고서를 검증합니다.

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports:validate

조정 보고서 업로드

조정 보고서가 유효한지 확인한 후 다음 예와 같이 Google에 업로드할 수 있습니다.

POST https://travelpartner.googleapis.com/v3/accounts/12345678/reconciliationReports