이 XML 참조 가이드는 이용 가능 여부, 요금, 인벤토리 (ARI) 피드에 사용할 수 있는 다양한 메시지, 요소, 속성에 관한 자세한 참조 콘텐츠와 코드 예를 제공합니다.
ARI는 1박 요금, 예약 가능 여부, 인벤토리를 제어하는 가격 제공 모드로, 이를 결합하는 방법에 관한 제한사항을 제공합니다. ARI에서는 세금, 수수료, 프로모션을 유연하게 포함할 수도 있습니다.
ARI는 이용 가능 여부 및 인벤토리를 정의하기 위한 일부 기본 메시지 유형에 대해 OpenTravel Alliance (OTA)의 표준 프로토콜을 따릅니다.
LOS 기반 가격 책정
LOS-based 가격을 사용하면 숙박 날짜가 아닌 체크인 날짜 및 숙박 기간에 따라 요금을 지정할 수 있습니다. LOS 기반 가격 책정에 <StatusApplicationControl> 요소를 지정하는 경우 @Start 및 @End 속성은 LOS 요금이 적용되는 체크인 날짜 범위를 나타냅니다.
LOS 기반 가격 책정을 사용하는 경우 1박 요금이 더 이상 적용되지 않지만 다른 모든 ARI 기능 (인벤토리, 예약 가능 여부, 규칙, 프로모션 등)은 여전히 이러한 요금에 적용될 수 있으며 1박 수준으로 지정됩니다. 즉, 시스템이 LOS 기반 가격 책정 시스템과 더 밀접하게 부합하면 야간 이용 가능 여부 및 제한 업데이트를 통해 제공되는 대역폭 효율성 외에도 풍부한 ARI 기능 세트를 계속 활용할 수 있습니다.
계정에 LOS 기반 가격 책정을 사용 설정하려면 TAM에 문의하거나 Google에 문의하세요.
각 메시지에는 사용자가 특정 체크인/체크아웃 날짜 및 숙박 인원으로 숙박 시설을 검색할 때 Google에서 사용자에게 표시되는 가격과 예약 가능 여부를 계산하는 데 사용하는 정보의 하위 집합이 포함됩니다.
ARI XML 참조 업데이트 기록
다음 표에는 기능 변경사항에 관한 문서 업데이트만 나와 있습니다.
날짜
변경사항
2020년 8월 14일
첫 출시입니다.
2020년 10월 21일
프로모션 메시지 유형이 추가되었습니다.
2020년 11월 17일
트랜잭션 (숙박 시설 데이터) 메시지의 경우 엔드포인트를 업데이트하고 action 속성을 PropertyDataSet 요소에 추가했습니다.
2020년 11월 24일
트랜잭션 (숙박 시설 데이터) 메시지에 <AllowablePackageIDs> 및 <AllowableRoomIDs> 요소를 추가했습니다.
2021년 2월 4일
응답 메시지를 추가했습니다.
2021년 2월 25일
OTA_HotelInvCountNotifRQ을 추가했습니다.
2020년 10월 21일
요금 수정 메시지 유형이 추가되었습니다.
All rights reserved. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThis XML reference guide details the messages, elements, and attributes for managing hotel availability, rates, and inventory using Availability, Rates, and Inventory (ARI) feeds.\u003c/p\u003e\n"],["\u003cp\u003eARI allows for LOS-based or per-date pricing, enabling flexible control over nightly rates, availability, inventory, taxes, fees, and promotions.\u003c/p\u003e\n"],["\u003cp\u003eKey ARI messages include: Transaction (Property Data), OTA_HotelRateAmountNotifRQ (Rates), OTA_HotelAvailNotifRQ (Availability), OTA_HotelInvCountNotifRQ (Inventory), and optional messages for taxes/fees, promotions, rate modifications, and extra guest charges.\u003c/p\u003e\n"],["\u003cp\u003eEach property should utilize either LOS-based or per-date rates, and all four primary message types (transaction, rate, inventory, and availability) are required for pricing to be available.\u003c/p\u003e\n"],["\u003cp\u003eOnly messages, elements, and attributes specifically documented in this ARI XML reference and the ARI guide are supported; for any additional pricing features used in your system, contact your Technology Account Manager (TAM).\u003c/p\u003e\n"]]],[],null,["# Availability, Rates, and Inventory (ARI) XML Reference\n\nThis XML reference guide provides detailed reference content and code\nexamples for the different messages, elements, and attributes available for\nAvailability, Rates, and Inventory (ARI) feeds.\n\nARI is a pricing delivery mode that controls nightly rates, availability,\nand inventory, and provides constraints on how these can be combined. ARI also\nprovides flexibility to include taxes, fees, and promotions.\n\nARI follows the standard protocols of OpenTravel Alliance (OTA) for some of\nthe main message types for defining availability and inventory.\n\n### LOS-based pricing\n\n`LOS-based` pricing lets you to specify rates per check-in date and length of\nstay, rather than per stay date. When you specify a\n`\u003cStatusApplicationControl\u003e` element for LOS-based pricing, the `@Start` and\n`@End` attributes signifies a range of check-in dates for which the LOS rates\napply.\n\nAlthough when using LOS-based pricing there are no longer nightly rates, all\nother ARI features (inventory, availability, rules, promotions, etc.) can still\nbe applied to these rates and are specified at a nightly level. This means if\nyour systems more closely align with an LOS-based pricing system, you can still\ntake advantage of the rich ARI feature set, in addition to the bandwidth\nefficiency that is granted by making use of the nightly availability and\nrestriction updates.\n| **Key Point:** Each property in your account should use either LOS-based rates or per-date rates.\n\nTo enable LOS-based pricing on your account, contact your TAM or\n[contact us](https://support.google.com/hotelprices/gethelp).\n| **Key Point:** You must send the four message types (transaction, rate, inventory, and availability) before pricing is available. It is recommended that you the size of ARI messages specifically `\u003cOTA_HotelRateAmountNotifRQ\u003e` to 5MB with a limit of 400 files per second upload rate.\n\nARI uses the following request messages:\n\n- [`Transaction` (Property Data)](/hotels/hotel-prices/xml-reference/ari-property). Defines the type and package\n (rate plan) information.\n\n- [`OTA_HotelRateAmountNotifRQ`](/hotels/hotel-prices/xml-reference/ari-rate). Defines the per-date or LOS-based\n occupancy rate amounts per product (room type and rate plan combination) for\n specific date ranges.\n\n- [`OTA_HotelAvailNotifRQ`](/hotels/hotel-prices/xml-reference/ari-avail). Defines availability and restrictions\n based on room type and rate plans. Inventory can also be updated using this\n message, but `OTA_HotelInvCountNotifRQ` is preferred.\n\n- [`OTA_HotelInvCountNotifRQ`](/hotels/hotel-prices/xml-reference/ari-inv). Defines the physical room inventory or\n number of rooms available to be sold.\n\n- [`TaxFeeInfo`](/hotels/hotel-prices/xml-reference/ari-tax). (Optional) Defines per-property taxes and fees. This\n message isn't required if `AmountAfterTax` is specified in the\n `OTA_HotelRateAmountNotifRQ` message.\n\n- [`Promotions`](/hotels/hotel-prices/xml-reference/ari-promotions). (Optional) Defines promotional rates for\n certain bookings, stays, and users.\n\n- [`RateModifications`](/hotels/hotel-prices/xml-reference/ari-rate-modifications). (Optional) Defines rate\n modification rules for certain bookings, stays, and users.\n\n- [`ExtraGuestCharges`](/hotels/hotel-prices/xml-reference/ari-extra-guest-charges). (Optional) Defines how rates\n should be configured for children and additional adults.\n\nEach message contains a subset of information that Google uses to compute the\nprices and availability displayed to users when they search for your\nproperties with specific check-in and check-out dates and occupancy.\n| **Key Point:** ARI features is limited to the messages and elements described within this Inventory \\& Pricing (ARI) XML reference and the ARI guide. Any OTA message, element, or attribute not specifically documented here is not supported in our ARI implementation.\n|\n|\n| Also, other [Transaction message](/hotels/hotel-prices/xml-reference/transaction-messages) elements not covered in\n| this Inventory \\& Pricing (ARI) XML reference are not supported when\n| using the ARI feed type.\n| Google continues to update and improve the API. If you use additional pricing features in your system, notify your `Technology Account Manager(TAM)` so that it can be prioritized with those features or they will let you know if those features are planned for a release.\n\nARI XML Reference revision history\n----------------------------------\n\nThe following table lists documentation updates for feature changes only.\n\n| Date | Changes |\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| August 14, 2020 | Initial release. |\n| October 21, 2020 | Added the Promotions message type. |\n| November 17, 2020 | For Transaction (Property Data) messages, updated the [endpoint](../dev-guide/ari-overview#pushing-messages) and added the `action` attribute to PropertyDataSet elements. |\n| November 24, 2020 | For Transaction (Property Data) messages, added the `\u003cAllowablePackageIDs\u003e` and `\u003cAllowableRoomIDs\u003e` elements. |\n| February 4, 2021 | Added response messages. |\n| February 25, 2021 | Added `OTA_HotelInvCountNotifRQ`. |\n| October 21, 2020 | Added the Rate Modifications message type. |"]]
