ARI 개요

예약 가능 여부, 요금, 인벤토리 (ARI)는 야간 요금, 예약 가능 여부, 인벤토리를 제어하는 가격 제공 모드이며, 이를 조합할 수 있는 방식에 관한 제약 사항을 제공합니다. ARI는 세금, 수수료, 프로모션을 유연하게 포함할 수도 있습니다.

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

이점

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

  • 대역폭 효율성: 전송해야 하는 데이터의 볼륨을 줄여 대역폭 효율성을 높입니다. 야간 ARI 데이터와 점진적인 변경사항만 전송함으로써 Google은 다양한 사전 구매 및 숙박 기간 값의 가격과 업데이트를 계산할 수 있습니다.

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

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

  • 유연성: 프로모션 및 패키지를 제공하여 유연성을 높일 수 있습니다.

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

요청 메시지 유형

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

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

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

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

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

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

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