با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این راهنمای مرجع XML محتوای مرجع و نمونه‌های کد مفصلی را برای پیام‌ها، عناصر و ویژگی‌های مختلف موجود برای فیدهای دسترسی، نرخ‌ها و موجودی (ARI) ارائه می‌کند.
ARI یک حالت تحویل قیمت است که نرخ‌های شبانه، در دسترس بودن و موجودی را کنترل می‌کند و محدودیت‌هایی را در مورد نحوه ترکیب آنها ایجاد می‌کند. ARI همچنین انعطاف‌پذیری را برای درج مالیات، هزینه‌ها و تبلیغات فراهم می‌کند.
ARI از پروتکل های استاندارد OpenTravel Alliance (OTA) برای برخی از انواع پیام های اصلی برای تعریف در دسترس بودن و موجودی پیروی می کند.
قیمت گذاری مبتنی بر LOS
قیمت‌گذاری LOS-based به شما امکان می‌دهد به‌جای تاریخ اقامت، نرخ‌ها را برای تاریخ ورود و مدت اقامت مشخص کنید. هنگامی که یک عنصر <StatusApplicationControl> را برای قیمت‌گذاری مبتنی بر LOS تعیین می‌کنید، ویژگی‌های @Start و @End نشان‌دهنده محدوده‌ای از تاریخ‌های ورود است که نرخ‌های LOS برای آنها اعمال می‌شود.
اگرچه هنگام استفاده از قیمت‌گذاری مبتنی بر LOS، دیگر نرخ‌های شبانه وجود ندارد، همه ویژگی‌های دیگر ARI (موجودی، در دسترس بودن، قوانین، تبلیغات و غیره) همچنان می‌توانند برای این نرخ‌ها اعمال شوند و در سطح شبانه مشخص می‌شوند. این بدان معناست که اگر سیستم‌های شما با یک سیستم قیمت‌گذاری مبتنی بر LOS هماهنگ‌تر باشد، همچنان می‌توانید از مجموعه ویژگی‌های غنی ARI، علاوه بر کارایی پهنای باند که با استفاده از در دسترس بودن شبانه و به‌روزرسانی‌های محدودیت اعطا می‌شود، استفاده کنید.
برای فعال کردن قیمت گذاری مبتنی بر LOS در حساب خود، با TAM خود تماس بگیرید یا با ما تماس بگیرید .
OTA_HotelRateAmountNotifRQ . مقادیر نرخ اشغال در هر تاریخ یا LOS را برای هر محصول (ترکیب نوع اتاق و طرح نرخ) برای بازه‌های تاریخ خاص تعریف می‌کند.
OTA_HotelAvailNotifRQ . در دسترس بودن و محدودیت ها را بر اساس نوع اتاق و برنامه های نرخ تعریف می کند. موجودی نیز می تواند با استفاده از این پیام به روز شود، اما OTA_HotelInvCountNotifRQ ترجیح داده می شود.
OTA_HotelInvCountNotifRQ . موجودی اتاق فیزیکی یا تعداد اتاق های موجود برای فروش را تعریف می کند.
TaxFeeInfo (اختیاری) مالیات ها و هزینه های هر ملک را تعریف می کند. اگر AmountAfterTax در پیام OTA_HotelRateAmountNotifRQ مشخص شده باشد، این پیام ضروری نیست.
Promotions (اختیاری) نرخ های تبلیغاتی را برای رزرو، اقامت و کاربران خاص تعریف می کند.
RateModifications (اختیاری) قوانین تغییر نرخ را برای رزرو، اقامت و کاربران خاص تعریف می کند.
ExtraGuestCharges (اختیاری) نحوه پیکربندی نرخ‌ها را برای کودکان و بزرگسالان دیگر تعریف می‌کند.
هر پیام حاوی زیرمجموعه‌ای از اطلاعات است که Google برای محاسبه قیمت‌ها و در دسترس بودن نمایش داده شده به کاربران در هنگام جستجوی دارایی‌های شما با تاریخ‌های مشخص ورود و خروج و اشغال استفاده می‌کند.
تاریخچه بازبینی مرجع ARI XML
جدول زیر به‌روزرسانی‌های اسناد را فقط برای تغییرات ویژگی فهرست می‌کند.
تاریخ
تغییرات
14 آگوست 2020
انتشار اولیه.
21 اکتبر 2020
نوع پیام تبلیغاتی اضافه شد.
17 نوامبر 2020
برای پیام‌های تراکنش (داده‌های ویژگی)، نقطه پایانی را به‌روزرسانی کرد و ویژگی action را به عناصر PropertyDataSet اضافه کرد.
24 نوامبر 2020
برای پیام‌های تراکنش (داده‌های ویژگی)، عناصر <AllowablePackageIDs> و <AllowableRoomIDs> را اضافه کنید.
4 فوریه 2021
پیام های پاسخ اضافه شده است.
25 فوریه 2021
OTA_HotelInvCountNotifRQ اضافه شد.
21 اکتبر 2020
نوع پیام تغییرات نرخ را اضافه کرد.
کلیه حقوق محفوظ است. Java علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
