Release Notes

Travel Partner API 버전 3에서는 다음을 프로그래매틱 방식으로 이용할 수 있습니다.

  • Hotel Center와 Google Ads 간의 계정 연결 관리
  • 선택한 호텔 설정 관리
  • 브랜드 및 아이콘 관리 (비공개 베타)
  • 속성 실적 보고서 보기 서비스를 통한 속성 성능 데이터
  • 호텔 뷰 서비스를 통한 호텔 데이터
  • 참여 보고서 보기 서비스를 통한 참여 보고서 데이터
  • 가격 정확도 뷰 서비스를 통한 가격 정확도 데이터
  • 가격 적용 범위 뷰 서비스를 통한 가격 적용 범위 데이터
  • 가격 뷰 서비스를 통한 운항 일정 및 가격 데이터
  • 조정 보고서 서비스를 통한 수수료 조정 보고서 관리(수수료(실제 숙박 건당 지불 파트너)만 해당)

엔드포인트

HTTPS 호출에서 REST-ful 구문을 통해 Travel Partner API 엔드포인트에 액세스할 수 있습니다. 모든 요청의 기본 URL은 다음과 같습니다.

https://travelpartner.googleapis.com

서비스 엔드포인트
계정 연결

Google Ads 계정과 Hotel Center 계정 간의 연결을 관리합니다.

POST /v3/accounts/account id/accountLinks
DELETE /v3/accounts/account id/accountLinks/account link id
GET /v3/accounts/account id/accountLinks/account link id
GET /v3/accounts/account id/accountLinks
PATCH /v3/accounts/account id/accountLinks/account link id

브랜드

브랜드 구성 수정 (비공개 베타)

POST /v3/accounts/account id/brands
GET /v3/accounts/account id/brands
PATCH /v3/accounts/account id/brands/brand id

호텔

선택한 호텔 설정을 수정합니다.

POST /v3/accounts/account id/hotels:setLiveOnGoogle

호텔 뷰

호텔 뷰 목록 또는 요약을 반환합니다.

GET /v3/accounts/account id/hotelViews
GET /v3/accounts/account id/hotelViews:summarize

아이콘

아이콘 관리 (비공개 베타)

POST /v3/accounts/account id/icons
GET /v3/accounts/account id/icons/icon id

참여 보고서 보기

참여 보고서 보기를 반환하거나, 쿼리를 사용하여 보기 데이터의 필터링된 하위 집합을 반환합니다.

GET /v3/accounts/account id/participationReportViews
GET /v3/accounts/account id/participationReportViews:query

가격 정확도 뷰

특정 가격 정확도 뷰, 사용 가능한 정확도 뷰 또는 요약을 반환합니다.

GET /v3/accounts/account id/priceAccuracyViews/report date
GET /v3/accounts/account id/priceAccuracyViews
GET /v3/accounts/account id/priceAccuracyViews:summarize

가격 범위 보기

최신 가격 범위 보기 또는 전체 범위 기록을 반환합니다.

GET /v3/accounts/account id/priceCoverageViews:latest
GET /v3/accounts/account id/priceCoverageViews

가격 보기

요청된 가격 뷰를 자세히 반환합니다.

GET /v3/accounts/account id/priceViews/partner hotel id

속성 실적 보고서 보기

쿼리를 사용하여 속성 실적 보고서 보기를 반환합니다.

GET /v3/accounts/account id/participationReportViews:query

조정 보고서

수수료 조정 보고서 생성, 확인, 가져오기 (호텔 광고만 해당)

POST /v3/accounts/account id/reconciliationReports
POST /v3/accounts/account id/reconciliationReports:validate
GET /v3/accounts/account id/reconciliationReports/datetime~filename
GET /v3/accounts/account id/reconciliationReports

호텔 광고 센터에 있는 계정 탭의 계정 정보 보기에서 계정 ID를 조회할 수 있습니다.

변경 로그

Travel Partner API v2.1의 많은 서비스가 Google Ads API로 이전되었습니다. 따라서 Travel Partner API v3는 호텔 전용 서비스만 유지합니다.

호텔 보기 서비스

  • HotelViewService.ListHotelViews (이전 명칭: Hotels API)
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/hotels에서 https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews으로 변경되었습니다.
    • type 요청 매개변수가 삭제되었습니다.
    • 응답에서 manifestOnly 필드가 삭제되었습니다.
    • 일부 필드 이름이 변경되었습니다.
  • HotelViewService.SummarizeHotelViews(이전 Scorecard API의 hotel_list_stats)
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/hotel_list_stats에서 https://travelpartner.googleapis.com/v3/accounts/4200042/hotelViews:summarize으로 변경되었습니다.
    • 일부 필드 이름이 변경되었습니다.

ParticipationReportViewService (스코어카드 API의 기회_통계)

  • ParticipationReportService.QueryParticipationReport
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/opportunity_stats에서 https://travelpartner.googleapis.com/v3/accounts/4200042/participationReportViews:query으로 변경되었습니다.
    • 쿼리 매개변수가 추가되었습니다.
    • 필드 이름이 변경되고 재구성되었습니다.

PriceAccuracyViewService (이전 price_accuracy report API)

  • PriceAccuracyViewService.ListPriceAccuracyViews
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy에서 https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews으로 변경되었습니다.
    • 새 API는 이전 버전과 달리 호텔 보기 리소스 이름 목록을 반환하며, 이는 보고서 날짜 목록을 반환합니다.
  • PriceAccuracyViewService.ListPriceAccuracyViews
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/reports/price_accuracy/20190909에서 https://travelpartner.googleapis.com/v3/accounts/4200042/priceAccuracyViews/20190909으로 변경되었습니다.
    • CSV 출력은 더 이상 지원되지 않습니다.
    • 일부 필드 이름이 변경되었습니다.

가격 적용 범위 보기 서비스

  • PriceAccuracyViewService.ListPriceCoverageViews (이전 Scorecard API의 price_coverage_stats_history)
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats_history에서 https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews으로 변경되었습니다.
    • 일부 필드 이름이 변경되었습니다.
  • PriceAccuracyViewService.GetLatestPriceCoverageViews (이전 Scorecard API의 price_coverage_stats)
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/scorecard/price_coverage_stats에서 https://travelpartner.googleapis.com/v3/accounts/4200042/priceCoverageViews:latest으로 변경되었습니다.
    • 일부 필드 이름이 변경되었습니다.

PriceViewService (이전의 Price API)

  • PriceViewService.GetPriceView
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/prices/hotel_id에서 https://travelpartner.googleapis.com/v3/accounts/4200042/priceViews/hotel_id으로 변경되었습니다.
    • 일부 필드 이름이 변경되었습니다.
    • 응답에서 입찰가 정보를 삭제했습니다.

ReconciliationReportService 메서드 (이전 Reconciliation Reports API)

  • ReconciliationReportService.ListReconciliationReports
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports에서 https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports으로 변경되었습니다.
  • ReconciliationReportService.GetReconciliationReport
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/datetime/filename에서 https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports/datetime~filename으로 변경되었습니다.
  • ReconciliationReportService.CreateReconciliationReport
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports에서 https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports으로 변경되었습니다.
  • ReconciliationReportService.ValidateReconciliationReport
    • API 엔드포인트가 https://www.googleapis.com/travelpartner/v2.1/4200042/reconciliation_reports/validate에서 https://travelpartner.googleapis.com/v3/accounts/4200042/reconciliationReports:validate으로 변경되었습니다.

지원 중단

지원 중단됨
은 API 버전이 계속 정상적으로 작동하지만 새로운 기능 또는 버그 수정 등의 지원이 제한되어 또한 특정 버전이 지원 중단되면 지원 중단 날짜가 결정됩니다.
일몰
은 API 버전이 삭제되어 더 이상 사용할 수 없음을 나타냅니다. 지원 중단과 서비스 종료 사이의 최소 시간은 3개월입니다.

다음 표에는 API 버전의 현재 일정, 지원 중단 및 지원 중단 날짜가 나와 있습니다.

버전 지원 중단 날짜 서비스 종료일
v3.0 N/A N/A
v2.1 2019년 9월 2020년 5월 31일
v2.0 (Bids API) 2018년 2월 2018년 5월
v2.0 (기타 모든 API) 2019년 9월 2020년 2월 15일
v1.2 2018년 2월 2018년 5월
v1.1 2016년 6월 2016년 10월
v1.0 2015년 4월 2015년 10월

인증

Travel Partner API에 액세스하려면 클라이언트가 OAuth2 인증을 사용하여 인증해야 합니다.

OAuth를 사용하여 Travel Partner API에 연결하는 애플리케이션에 대한 추가 정보와 예시는 API 인증을 참조하세요.