Pull 또는 Pull with Hints 전달 방식을 지원하지 못하도록 시스템에서 제한한 경우 문의 양식을 사용하세요.
푸시 전송 모드 개요
푸시 전송 모드를 사용하면 가격 또는 재고가 변경될 때마다 증분 업데이트를 전송합니다.
다음 이미지는 푸시 전송 모드의 요청/응답 흐름을 보여줍니다.
프로토콜 구성 파일에서 푸시 구성
푸시 전송 모드로 가격을 업데이트하려면 프로토콜 구성 파일에서 다음 요소를 지정합니다. Hotel Price API를 사용하도록 환경을 처음 구성하는 경우에만 이 작업을 수행합니다.
<Model>:<Model>요소의 값을 'push'로 설정합니다.<WhitelistedIPs>: 사용자와 Google 간의 통신을 인증하는 데 사용하는 IP 주소를 나열합니다. 이 요소의 값은 세미콜론으로 구분된 IP 주소 목록이거나 CIDR 표기법을 사용한 IP 주소 범위일 수 있습니다. 형식은 xxx.xxx.xxx.xxx/YY입니다.
다음 예는 푸시를 사용하는 파트너를 위한 프로토콜 구성 파일을 보여줍니다.
<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
<Model>push</Model>
<WhiteListedIPs>216.239.32.0/19;64.233.160.0/19</WhiteListedIPs>
</Configuration>
자세한 내용은 프로토콜 구성 파일을 참조하세요.
푸시로 가격 업데이트
푸시로 데이터를 업데이트하려면 데이터가 변경될 때마다 트랜잭션 메시지를 보내세요.
거래 메시지를 보낼 때는 다음 가이드라인을 따르세요.
- 다음 엔드포인트로 메시지를 보냅니다.
http://www.google.com/travel/hotels/uploads/price
- HTTP POST 메서드를 사용합니다.
Content-Type헤더를 'application/xml'로 설정합니다.- 메시지 본문은 가격 설정(가격 책정 업데이트) 또는 Room 및 패키지 메타데이터 정의(메타데이터 업데이트용)에 설명된 대로 트랜잭션 메시지 구문을 준수해야 합니다.
- 가격 책정의 경우 업데이트할 각 여행 일정에
<Result>요소를 정의합니다. 메타데이터 업데이트의 경우 변경된 각 속성에 대해 객실 데이터와 패키지 데이터를 정의합니다.
수신하는 각 트랜잭션 메시지에 대해 Google은 서버의 HTTP 200 OK 메시지로 응답하여 성공을 나타냅니다. Google에서 HTTP 오류 코드로 응답하면 트랜잭션 메시지를 다시 전송합니다. 메시지를 보내거나 받을 때 문제가 발생하면 피드 문제 해결을 참고하세요.
가격이 변경된 각 숙박 일정 (숙박 시설/체크인 날짜/숙박 기간 조합)에 관한 거래 메시지를 보내야 합니다. 초당 최대 5개의 트랜잭션 메시지를 보낼 수 있습니다. Google은 초당 5회를 초과하여 전송되는 메시지를 차단하지는 않지만 다른 요청이 완료되기를 기다리는 경우 메시지가 시간 초과될 수 있습니다.
네트워크 트래픽을 줄이려면 여러 <Result> 요소를 단일 트랜잭션 메시지로 결합하면 됩니다.
Google은 일반적으로 업데이트된 가격 및 재고 데이터를 약 5분 내에 처리합니다. 가격은 90일 후 삭제됩니다.
트랜잭션 메시지를 사용하여 가격을 업데이트하는 방법에 대한 자세한 내용은 가격 설정을 참조하세요.
푸시를 사용하여 Room 및 패키지 메타데이터 업데이트
객실 및 패키지 메타데이터를 업데이트하려면 다른 업데이트와 마찬가지로 업데이트를 전송합니다. 이 경우 <RoomData> 및 <PackageData> 요소에 새 정보가 포함된 트랜잭션 메시지를 보냅니다. 이러한 요소는 <PropertyDataSet> 요소의 하위 요소입니다.
자세한 내용은 Room 및 패키지 메타데이터 정의를 참고하세요.
전송 모드 오류
Google에 트랜잭션 메시지를 보낼 때 HTTP 오류가 발생하면 1분, 5분, 20분 간격으로 요청을 다시 시도하세요. 3번 시도한 후에도 문제가 지속되면 메시지 전송을 중지하고 Google 계정 관리자에게 문의하세요.
거래 메시지를 보낼 때 표시된 HTTP 오류를 보고하기 위해 Google 계정 관리자에게 문의하는 경우 Google에서는 피드가 제대로 구성되었는지 확인하는 동안 사용자와 약 10개의 호텔 테스트를 실행합니다. 테스트가 성공하면 Google에서 호텔 가격 피드에 지정된 모든 호텔 세트를 크롤링합니다. 이렇게 하면 로드가 허용되고 가격이 3~5일 동안 정확하게 유지됩니다. 이후 Google에서 결과를 알려 주면 결과를 실시간으로 참조할 수 있습니다.
가격을 어떤 빈도로 푸시해야 하나요?
가격이 변경되었음을 확인하는 즉시 모든 업데이트를 푸시하는 것이 좋습니다. 가격 변동 시점을 알 수 없는 경우 가능한 한 자주 가격을 업데이트해 보아야 합니다. 일반적으로 하루에 여러 번 푸시됩니다. 일반적으로 운항 날짜와 요일이 훨씬 더 자주 푸시됩니다.