ARI 개요

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

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

이점

ARI의 이점은 다음과 같습니다.

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

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

  • 더 넓은 가격 범위: 다양한 숙박 일정에 결합된 세부적인 데이터를 사용하여 더 넓은 가격 범위 (가격이 포함된 숙박 일정 수)를 달성합니다.

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

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

요청 메시지 유형

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

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

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

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

  • OTA_HotelRateAmountNotifRQ. 특정 기간에 대한 제품(객실 유형 및 요금제 조합)별 숙박 인원 요금 금액(일별 또는 숙박 일수 기준)을 정의합니다.

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

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

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

  • 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의 피드 상태 페이지에서 특정 메시지에 발생한 문제를 확인할 수도 있습니다.

Live on 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 참조를 참고하세요.