호텔 가격은 체크인 날짜와 숙박 일수의 조합인 주어진 일정의 2인실 최저 가격입니다.
개요
호텔 또는 숙박 일정 조합에 대해 정의한 가격은 호텔 검색 결과의 중심입니다. 가격이 최신 상태이고 정확하며 경쟁력 있는 것이 매우 중요합니다.
Google은 일반적으로 검색 결과를 표시할 때 가격 캐시의 가격을 사용합니다. 가격 업데이트가 포함된 거래 메시지를 Google에 전송할 때마다 Google은 해당 데이터를 캐시합니다.
Google은 호텔 광고 계정의 업데이트된 가격을 실시간으로 요청할 수도 있습니다. 사용자가 특정 호텔 또는 여행 일정 조합을 검색하면 Google에서 '실시간' 요청 또는 실시간 요금 쿼리 메시지를 보낼 수 있습니다. 지정된 기간 내에 응답하면 해당 가격이 사용자가 요청한 일정의 결과에 표시될 수 있습니다. Google은 향후 요청에 제공될 수 있도록 실시간 요금 쿼리의 결과를 캐시합니다.
가격 업데이트 크기
객실 요금을 설정할 때는 고급 예약 및 숙박 기간 (LoS) 값을 제공하며, 이러한 값과 객실 ID 또는 요금제 ID의 각 조합에 대한 요금을 제공합니다. 예약 및 LoS 값은 기본적으로 다음과 같습니다.
- 최대 330일 사전 예약
- 최대 30박 숙박
이러한 일반 가이드라인에 따라 단일 객실의 가격에는 체크인 날짜와 숙박 일수의 각 조합에 대해 하나씩 최대 9,900개의 별도 항목 (330 * 30)이 필요할 수 있습니다.
다음 매트릭스는 단일 호텔의 일정 데이터 일부를 보여줍니다. 행렬의 가격이 있는 각 셀은 체크인 날짜와 숙박 기간의 한 여행 일정 조합을 나타냅니다. 각 여행 일정은 Google에서 숙박 시설에 요청하는 별도의 값을 나타냅니다.
가격이 다시 책정되는 호텔 및 숙박 일정
Google 가격이 표시되는 호텔은 호텔 목록에 따라 결정됩니다. 사용 중지되지 않은 경우 호텔 목록 피드의 모든 호텔은 트랜잭션 메시지 또는 경우에 따라 실시간 가격 쿼리를 사용하여 가격이 다시 책정됩니다.
가격 업데이트
가격을 업데이트하는 일반적인 절차는 다음과 같습니다.
초기 설정 중에 호텔 목록에서 가격을 책정할 호텔을 정의한 다음 목록이 변경될 때 주기적으로 업데이트합니다.
변동된 요금만 해당: Google에서 서버로 힌트 요청 메시지를 보냅니다.
변동된 요금만: 서버가 가격을 다시 책정해야 하는 호텔 또는 여행 일정 조합을 정의하는 힌트 응답 메시지로 응답합니다.
Google에서 서버에 질의 메시지를 보냅니다. 질의 메시지에는 Google에서 가격이 필요한 호텔 ID와 여행 일정이 포함됩니다.
실시간 가격 쿼리의 경우 호텔 또는 숙박 일정이 현재 입찰에 표시되려면 응답해야 하는 시간 제한이 Google에 의해 지정됩니다.
서버는 새 가격을 정의하는 트랜잭션 메시지로 응답합니다.
Google은 거래 메시지의 가격 데이터로 캐시를 업데이트합니다.
Pull 및 변경된 가격에 대한 자세한 내용은 전송 모드를 참고하세요.
거래 메시지를 사용한 가격 책정
호텔 또는 여행 일정 (체크인 날짜와 숙박 일수의 조합)의 가격을 설정하려면 각 여행 일정에 대해 하나의 <Result>이 있는 거래 메시지를 사용하세요.
가격을 설정할 때는 다음 가이드라인을 따르세요.
요금: 각 여정에 대해 이용 가능한 최저 2인실 요금을 제공합니다. 사이트에 표시되는 요금과 다른 요금을 Hotel Prices API로 설정하면 사용자에게 혼란을 줄 수 있으며 예약이 취소될 수 있습니다.
숙박 일수: 각 숙박 일정의 총 숙박 비용과 1박당 요금을 지정합니다. Google에서 1박당 요금을 계산합니다.
정책: 요금을 설정할 때 Google의 가격 정확도 정책을 준수하세요. 이를 위해서는 Google 검색 결과에 표시되는 가격이 최종 예약 가격과 크게 다르지 않아야 합니다.
모든 경비 포함 가격: 미국 및 캐나다 최종 사용자의 등록정보에 표시되려면 호텔에서 일반적으로 기본 요금에서 세금과 수수료를 구분해야 합니다. 자세한 내용은 세금 및 수수료 정책을 참고하세요.
반올림: 가격, 세금, 수수료의 값을 반올림하지 마세요.
인벤토리에서 호텔을 삭제하는 방법에 대한 자세한 내용은 인벤토리 삭제를 참고하세요.
가격 책정 메시지
거래 메시지를 사용하여 여정의 가격을 다시 매길 때는 <Result>의 다음 하위 요소가 필요합니다.
<Property><Baserate><Tax><OtherFees><Checkin>(일정)<Nights>(일정)
거래 메시지에 <Result>의 다음 하위 요소를 optionally 포함할 수 있습니다.
<AllowablePointsOfSale><ChargeCurrency><Custom[1-5]><RoomBundle><RoomID>
이러한 각 요소에 대한 자세한 내용은 <Transaction>를 참고하세요.
가격 책정 예시
다음 예에서는 체크인 날짜가 6월 7일인 1~7박 숙박의 객실 (기본 2인 숙박) 가격을 설정합니다.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-08-24T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">209.99</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">419.98</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>3</Nights>
<Baserate currency="USD">614.97</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>4</Nights>
<Baserate currency="USD">819.96</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>5</Nights>
<Baserate currency="USD">999.95</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>6</Nights>
<Baserate currency="USD">1193.94</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>7</Nights>
<Baserate currency="USD">1259.93</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
</Transaction>
메시지의 총 크기가 100MB를 초과하지 않는 한 각 트랜잭션 메시지에는 원하는 수의 <Result> 요소가 있을 수 있습니다.
가격 업데이트 빈도
가격이 변경될 때마다 가격을 업데이트해야 합니다. 이 작업의 방법은 가격 정보 업데이트 시 풀 또는 변경된 가격 방법을 선택했는지에 따라 다릅니다. 자세한 내용은 전송 모드 선택을 참고하세요.
Google에서 전송하는 실시간 요금 쿼리의 빈도와 수도 구성할 수 있습니다. 자세한 내용은 실시간 가격 책정 쿼리를 참고하세요.
올인클루시브 가격
사용자의 지리적 위치에 따라 항목별 가격 책정 대신 포괄적인 가격 책정을 사용하는 것이 좋습니다.
올인클루시브 가격에는 거래 메시지의 <Baserate> 요소에 있는 객실의 기본 요율과 세금 및 수수료의 총 가치가 포함됩니다. Itemized 가격은 가격을 <Baserate>, <Taxes>, <OtherFees> 요소로 구분합니다.
