ARI 개요

이용 가능 여부, 요금, 인벤토리 (ARI)는 야간 요금, 예약 가능 여부, 인벤토리를 관리하고 결합 방법에 관한 제약 조건을 제공하는 가격 제공 모드입니다. 또한 ARI는 세금, 수수료, 프로모션을 유연하게 포함할 수 있습니다.

운항 일정 기반 가격 책정 배송 모드, 가져오기 및 변동된 가격 책정과 달리 ARI 피드는 특정 가격이나 여행 일정에 대해 쿼리되지 않습니다. 대신 가격 책정 모델에 요금 세부정보, 제한사항, 예약 가능 여부 변경과 같이 새로운 데이터 또는 변경된 데이터가 있을 때 메시지를 푸시합니다.

이점

ARI는 다음과 같은 이점을 제공합니다.

  • 대역폭 효율성: 전송해야 하는 데이터 볼륨을 줄여 대역폭 효율성을 높입니다. 야간 ARI 데이터와 증분 변경사항만 전송하여 Google에서 다양한 사전 구매 및 숙박 기간에 따른 가격 및 업데이트를 계산할 수 있습니다.

  • 가격 정확도: 변경 시 푸시 이벤트 모델을 사용하여 실시간 업데이트를 제공하여 가격 정확도를 개선합니다.

  • 더 넓은 가격 범위: 다양한 여행 일정으로 결합되는 세분화된 데이터를 사용하여 더 높은 가격 범위 (가격이 포함된 여행 일정 수)를 달성합니다.

  • 유연성: 프로모션과 패키지를 더 유연하게 제공할 수 있습니다.

  • 사용 편의성: 시스템에 저장되는 방식에 맞게 데이터를 전송하므로 여러 운항 일정의 가격을 계산하거나 캐시할 필요가 없습니다.

요청 메시지 유형

Google로 전송된 ARI 메시지를 ARI '요청' 메시지라고 합니다. 이후 Google은 성공 또는 실패를 나타내는 '응답' 메시지를 반환합니다.

ARI는 가용성 및 인벤토리를 정의하기 위한 일부 기본 메시지 유형에서 OpenTravel Alliance (OTA)의 표준 프로토콜을 따릅니다.

<OTA_HotelRateAmountNotifRQ>

ARI는 다음 요청 메시지를 사용합니다.

  • Transaction (숙박 시설 데이터). 객실 유형 및 패키지 (요금제) 정보를 정의합니다.

  • OTA_HotelRateAmountNotifRQ. 특정 기간의 제품당 (객실 유형 및 요금제 조합) 날짜별 또는 LOS 기반 점유율을 정의합니다.

  • OTA_HotelAvailNotifRQ. 객실 유형 및 요금제에 따라 이용 가능 여부 및 제한사항을 정의합니다. 이 메시지를 사용하여 인벤토리를 업데이트할 수도 있지만 OTA_HotelInvCountNotifRQ를 사용하는 것이 좋습니다.

  • OTA_HotelInvCountNotifRQ. 판매 가능한 실제 객실 인벤토리 또는 객실 수를 정의합니다.

  • TaxFeeInfo. (선택사항) 숙박 시설별 세금 및 수수료를 정의합니다. OTA_HotelRateAmountNotifRQ 메시지에 AmountAfterTax가 지정된 경우에는 이 메시지가 필요하지 않습니다.

  • Promotions. (선택사항) 특정 예약, 숙박, 사용자의 프로모션 요금을 정의합니다.

  • RateModifications. (선택사항) 특정 예약, 숙박, 사용자의 요금 수정 규칙을 정의합니다.

  • ExtraGuestCharges. (선택사항) 어린이 및 추가 성인의 요금 구성 방법을 정의합니다.

각 메시지에는 사용자가 특정 체크인 및 체크아웃 날짜, 원하는 숙박 인원이 포함된 숙박 시설을 검색할 때 Google에서 사용자에게 표시되는 가격과 이용 가능 여부를 계산하는 데 사용하는 정보의 하위 집합이 포함됩니다.

ARI에 관한 자세한 내용은 XML 참조를 참고하세요.

푸시 메시지

ARI 및 속성 정보를 업데이트하려면 시스템에서 데이터가 변경될 때마다 관련 메시지를 전송합니다.

메일을 보낼 때는 다음 가이드라인을 따르세요.

  • Hotel Center 가격 설정 페이지의 셀프 서비스 도구를 사용하여 Google 시스템의 IP 주소를 추가하거나 업데이트합니다.

  • 엔드포인트에 다음 기본 경로를 사용합니다.

    • https://www.google.com 또는 Host: www.google.com Port: 443

  • HTTP POST 메서드를 사용하여 메시지를 보냅니다.

  • Content-Type 헤더를 application/xml로 설정합니다.

  • 계정 수준의 최대 업데이트 속도는 메시지 400개/초입니다. 이 한도를 초과하면 6032 오류 코드가 반환됩니다.

  • 업데이트할 데이터에 따라 다음 경로를 사용합니다.

    • Transaction (숙박 시설 데이터): /travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ: /travel/hotels/uploads/ota/hotel_rate_amount_notif
    • OTA_HotelAvailNotifRQ: /travel/hotels/uploads/ota/hotel_avail_notif
    • OTA_HotelInvCountNotifRQ: /travel/hotels/uploads/ota/hotel_inv_count_notif
    • TaxFeeInfo: /travel/hotels/uploads/taxes
    • Promotions: /travel/hotels/uploads/promotions
    • RateModifications: /travel/hotels/uploads/rate_modifications
    • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

서버에 성공적으로 연결된 경우 Google은 수신된 각 요청 메시지에 대해 HTTP 200 OK로 응답하고 업데이트가 성공적으로 적용되었는지 또는 경고 또는 오류가 발생했는지 나타내는 응답 메시지와 함께 본문을 포함합니다. Google에서 HTTP 오류 코드로 응답하면 메시지를 다시 보냅니다. HTTP 응답 본문에 경고 또는 오류가 포함된 경우 메시지를 다시 보내기 전에 해결해야 합니다. Hotel Center의 피드 상태 페이지에서 특정 메시지에 발생하는 문제를 확인할 수도 있습니다.

Google에 게시 (LoG)

Google에 게시 (LoG)를 사용하면 Google 웹사이트에 내 호텔을 표시할 수 있습니다. 호텔의 기본 LoG 값은 true이므로 새 호텔은 자동으로 Google에 표시됩니다.

LoG를 사용하면 Google Ads의 상태 또는 숙박 시설의 요금이 Google에 있는지 여부에 관계없이 Hotel Center 계정에서 광고 및 무료 예약 링크에 숙박 시설을 사용 설정하거나 사용 중지할 수 있습니다. 이는 호텔에만 적용되며 공유숙박에는 적용되지 않습니다.

호텔의 LoG 값을 설정하는 방법에는 두 가지가 있습니다. Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API.

LoG에 대한 자세한 내용은 Hotel Center 도움말을 참고하세요.

Travel Partner API, you can do the following: 사용

  • Hotel Center를 통해 숙박 시설의 상태를 확인하거나 hotelViews.list 엔드포인트를 사용하세요.

  • hotelViews.list 엔드포인트에서 liveOnGoogle = TRUE와 함께 filter 매개변수를 사용하여 Google에 표시되는 모든 호텔 목록을 가져옵니다.

  • hotelViews.summary를 사용하여 Google에 게시 중인 숙박 시설 수를 포함한 특정 계정의 속성 요약을 가져옵니다.

API를 사용하여 LoG를 설정하는 방법에 대한 자세한 내용은 hotelViews.list 도움말과 API 참조를 참고하세요.