이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Release Notes

여행 파트너 API 버전 3을 사용하면 다음 항목에 프로그래매틱 방식으로 액세스할 수 있습니다.

Hotel Center와 Google Ads 간 계정 연결 관리
선택한 호텔 설정 관리
브랜드 및 아이콘 관리 (비공개 베타)
숙박 시설 실적 보고서 뷰 서비스를 통한 숙박 시설 실적 데이터
호텔 뷰 서비스를 통한 호텔 데이터
참여 보고서 뷰 서비스를 통한 참여 보고서 데이터
가격 정확도 뷰 서비스를 통한 가격 정확도 데이터
Price Coverage Views Service를 통한 가격 범위 데이터
가격 보기 서비스를 통한 여정 및 가격 데이터
조정 보고서 서비스를 통한 수수료 조정 보고서 관리 (수수료 투숙당지불 파트너만 해당)

엔드포인트

여행 파트너 API 엔드포인트는 HTTPS 호출에서 RESTful 구문을 통해 액세스할 수 있습니다. 모든 요청의 기본 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`

Hotel Ads Center의 계정 탭에 있는 계정 정보 보기에서 계정 ID를 확인할 수 있습니다.

변경 로그

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

HotelViewService

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 (이전에는 스코어카드 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의 opportunity_stats)

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 보고서 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 출력은 더 이상 지원되지 않습니다.
- 일부 필드의 이름이 변경되었습니다.

PriceCoverageViewService

PriceAccuracyViewService.ListPriceCoverageViews (이전에는 스코어카드 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 (이전에는 스코어카드 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 (이전 명칭: Prices 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 메서드 (이전의 조정 보고서 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	해당 사항 없음	해당 사항 없음
v2.1	2019년 9월	2020년 5월 31일
v2.0 (입찰 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월

인증

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

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

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