با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
در دسترس بودن، نرخها و موجودی (ARI) یک حالت تحویل قیمت است که نرخهای شبانه، در دسترس بودن و موجودی را کنترل میکند و محدودیتهایی را در مورد نحوه ترکیب این موارد ارائه میکند. ARI همچنین انعطافپذیری را برای درج مالیات، هزینهها و تبلیغات فراهم میکند.
برخلاف حالتهای تحویل قیمتگذاری مبتنی بر برنامه سفر، قیمتگذاری کششی و تغییر یافته، فیدهای ARI برای قیمتها یا برنامههای سفر خاص درخواست نمیشوند. در عوض، زمانی که مدل قیمتگذاری شما دادههای جدید یا تغییر یافته دارد، مانند تغییرات در جزئیات نرخ، محدودیتها و در دسترس بودن، پیامها را ارسال میکنید.
مزایا
ARI مزایای زیر را ارائه می دهد:
کارایی پهنای باند : با کاهش حجم داده هایی که باید ارسال شوند، کارایی پهنای باند را افزایش می دهد. با ارسال دادههای ARI شبانه و فقط تغییرات تدریجی، Google میتواند قیمتها و بهروزرسانیها را برای طیف گستردهای از خریدهای اولیه و مقادیر مدت اقامت محاسبه کند.
دقت قیمت : دقت قیمت را با استفاده از مدل رویداد فشار بر تغییر برای ارائه بهروزرسانیهای زنده بهبود میبخشد.
پوشش قیمت بیشتر : با استفاده از داده های دانه ای که در برنامه های سفر مختلف ترکیب می شوند، به پوشش قیمت بالاتر (تعداد سفرها با قیمت ها) دست می یابد.
انعطاف پذیری : انعطاف پذیری بیشتری را با ارائه تبلیغات و بسته ها امکان پذیر می کند.
سهولت استفاده : داده ها را به گونه ای منتقل می کند که با نحوه ذخیره آن ها در سیستم شما هماهنگ باشد، و از نیاز به محاسبه یا ذخیره قیمت ها برای بسیاری از سفرها اجتناب می کند.
درخواست انواع پیام
پیام های ARI ارسال شده به Google به عنوان پیام های "درخواست" ARI نامیده می شوند. Google متعاقباً پیامهای «پاسخ» را برمیگرداند که نشاندهنده موفقیت یا شکست است.
ARI از پروتکل های استاندارد OpenTravel Alliance (OTA) برای برخی از انواع پیام های اصلی برای تعریف در دسترس بودن و موجودی پیروی می کند.
OTA_HotelRateAmountNotifRQ . مقادیر نرخ اشغال در هر تاریخ یا LOS را برای هر محصول (ترکیب نوع اتاق و طرح نرخ) برای بازههای تاریخ خاص تعریف میکند.
OTA_HotelAvailNotifRQ . در دسترس بودن و محدودیت ها را بر اساس نوع اتاق و برنامه های نرخ تعریف می کند. موجودی نیز می تواند با استفاده از این پیام به روز شود، اما OTA_HotelInvCountNotifRQ ترجیح داده می شود.
OTA_HotelInvCountNotifRQ . موجودی اتاق فیزیکی یا تعداد اتاق های موجود برای فروش را تعریف می کند.
TaxFeeInfo (اختیاری) مالیات ها و هزینه های هر ملک را تعریف می کند. اگر AmountAfterTax در پیام OTA_HotelRateAmountNotifRQ مشخص شده باشد، این پیام ضروری نیست.
Promotions (اختیاری) نرخ های تبلیغاتی را برای رزرو، اقامت و کاربران خاص تعریف می کند.
RateModifications (اختیاری) قوانین تغییر نرخ را برای رزرو، اقامت و کاربران خاص تعریف می کند.
ExtraGuestCharges (اختیاری) نحوه پیکربندی نرخها را برای کودکان و بزرگسالان دیگر تعریف میکند.
هر پیام حاوی زیرمجموعهای از اطلاعات است که Google برای محاسبه قیمتها و در دسترس بودن نمایش داده شده به کاربران هنگام جستجوی داراییهای شما با تاریخهای مشخص ورود و خروج و اشغال مورد نظر استفاده میکند.
برای اطلاعات بیشتر در مورد ARI، به مرجع XML مراجعه کنید.
پیام های فشاری
برای به روز رسانی ARI و اطلاعات دارایی، هر زمان که داده ها در سیستم شما تغییر کرد، پیام های مرتبط را ارسال کنید.
هنگام ارسال پیام از دستورالعمل های زیر استفاده کنید:
از ابزار self-serve در صفحه تنظیمات قیمت هتل مرکز برای افزودن یا به روز رسانی آدرس های IP خود در سیستم ما استفاده کنید.
از مسیر پایه زیر برای نقطه پایانی استفاده کنید:
https://www.google.com یا Host: www.google.com Port: 443
با استفاده از روش HTTP POST پیام ارسال کنید.
هدر Content-Type را روی application/xml تنظیم کنید.
حداکثر نرخ به روز رسانی در سطح حساب 400 پیام در ثانیه وجود دارد. اگر از این حد تجاوز کنید، کد خطای 6032 برگردانده می شود.
بسته به داده هایی که به روز می شوند از مسیرهای زیر استفاده کنید:
برای هر پیام درخواستی دریافت شده، در صورت موفقیت آمیز بودن اتصال به سرور، Google با یک HTTP 200 OK پاسخ می دهد و بدنه ای را با پیام پاسخی شامل می شود که نشان می دهد آیا به روز رسانی ها با موفقیت اعمال شده اند یا با اخطار یا خطا مواجه شده اند. اگر Google با کد خطای HTTP پاسخ داد، پیام را دوباره ارسال کنید. اگر بدنه پاسخ HTTP حاوی اخطار یا خطا باشد، باید قبل از ارسال مجدد پیام رفع شود. همچنین میتوانید مشکلات پیشآمده برای پیامهای خاص را در صفحه وضعیت فید در مرکز هتل مشاهده کنید.
زنده در Google (LoG)
Live on Google (LoG) به شما امکان می دهد هتل های خود را در وب سایت های Google نمایش دهید. از آنجایی که مقدار LoG پیشفرض برای یک هتل true است، هر هتل جدیدی بهطور خودکار در Google نمایش داده میشود.
از LoG برای روشن و خاموش کردن داراییهای خود برای تبلیغات و پیوندهای رزرو رایگان در حساب مرکز هتل خود، صرف نظر از وضعیت Google Ads یا اینکه آیا ملک دارای نرخهایی در Google است، استفاده کنید.
دو راه برای تنظیم مقدار 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 .
با استفاده از Travel Partner API, you can do the following:
وضعیت املاک خود را از طریق مرکز هتل مشاهده کنید یا از نقطه پایانی hotelViews.list استفاده کنید.
با استفاده از پارامتر filter با liveOnGoogle = TRUE در نقطه پایان hotelViews.list ، فهرستی از تمام هتل های خود را که در Google نمایش داده شده است، بازیابی کنید.
با استفاده از hotelViews.summary خلاصه ای از دارایی های یک حساب خاص از جمله تعداد دارایی های فعال در Google را دریافت کنید.
کلیه حقوق محفوظ است. Java علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eAvailability, Rates, and Inventory (ARI) is a pricing model that allows hotels to push updates on rates, availability, inventory, and other pricing details to Google.\u003c/p\u003e\n"],["\u003cp\u003eARI offers benefits like bandwidth efficiency, price accuracy, greater price coverage, flexibility, and ease of use.\u003c/p\u003e\n"],["\u003cp\u003eFour key message types (transaction, rate, inventory, availability) are required for pricing to be available on Google.\u003c/p\u003e\n"],["\u003cp\u003eLive on Google (LoG) allows hotels to control their visibility on Google for free and paid bookings and can be managed through Hotel Center or the Travel Partner API.\u003c/p\u003e\n"],["\u003cp\u003eHotels should send ARI updates whenever data changes and can use the provided endpoints to push their data to Google.\u003c/p\u003e\n"]]],[],null,["# ARI Overview\n\nAvailability, Rates, and Inventory (ARI) is a pricing delivery mode that\ncontrols nightly rates, availability, and inventory, and provides constraints on\nhow these can be combined. ARI also provides flexibility to include taxes, fees,\nand promotions.\n\nUnlike the itinerary-based pricing [delivery\nmodes](/hotels/hotel-prices/dev-guide/delivery-mode), Pull and Changed\nPricing, ARI feeds aren't queried for specific prices or itineraries. Instead,\nyou push messages when your pricing model has new or changed data, such as\nchanges to rate details, restrictions, and availability.\n\nBenefits\n--------\n\nARI offers the following benefits:\n\n- **Bandwidth efficiency**: Increases bandwidth efficiency by reducing the\n volume of data that needs to be transmitted. By sending nightly ARI data and\n only incremental changes, Google can compute prices and updates for a wide\n range of advance purchase and length of stay values.\n\n- **Price accuracy**: Improves price accuracy by using a push-on-change event\n model to give live updates.\n\n- **Greater price coverage**: Achieves a higher price coverage (number of\n itineraries with prices) by using granular data that is combined into various\n itineraries.\n\n- **Flexibility**: Enables greater flexibility with offering promotions and\n packages.\n\n- **Ease of Use**: Transmits data in a way that is aligned with how it is\n stored on your system, avoiding the need to compute or cache prices for\n many itineraries.\n\nRequest message types\n---------------------\n\nARI messages sent to Google are termed as ARI \"request\" messages. Google\nsubsequently returns \"response\" messages indicating success or failure.\n\nARI follows the standard protocols of `OpenTravel Alliance (OTA)` for some of\nthe main message types for defining availability and inventory.\n| **Key Point:** You must send the four message types---transaction, rate, inventory, and availability---before pricing is available. It is recommended that you limit 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).\n Defines the room type and package (rate plan) information.\n\n- [`OTA_HotelRateAmountNotifRQ`](/hotels/hotel-prices/xml-reference/ari-rate).\n Defines the per-date or LOS-based occupancy rate amounts per product (room\n type and rate plan combination) for specific date ranges.\n\n- [`OTA_HotelAvailNotifRQ`](/hotels/hotel-prices/xml-reference/ari-avail).\n Defines availability and restrictions based on room type and rate plans.\n Inventory can also be updated using this message, but\n `OTA_HotelInvCountNotifRQ` is preferred.\n\n- [`OTA_HotelInvCountNotifRQ`](/hotels/hotel-prices/xml-reference/ari-inv).\n Defines the physical room inventory or number of rooms available to be sold.\n\n- [`TaxFeeInfo`](/hotels/hotel-prices/xml-reference/ari-tax).\n (Optional) Defines per-property taxes and fees. This message isn't required\n if `AmountAfterTax`is specified in the `OTA_HotelRateAmountNotifRQ` message.\n\n- [`Promotions`](/hotels/hotel-prices/xml-reference/ari-promotions).\n (Optional) Defines promotional rates for certain bookings, stays, and\n users.\n\n- [`RateModifications`](/hotels/hotel-prices/xml-reference/ari-rate-modifications).\n (Optional) Defines rate modification rules for certain bookings, stays, and\n users.\n\n- [`ExtraGuestCharges`](/hotels/hotel-prices/xml-reference/ari-extra-guest-charges).\n (Optional) Defines how rates should be configured for children and\n 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 properties\nwith specific check-in and check-out dates and desired occupancy.\n\nFor more information about ARI, refer to the\n[XML Reference](/hotels/hotel-prices/xml-reference/ari-overview).\n\nPush messages\n-------------\n\nTo update ARI and property information, send the associated messages whenever\ndata changes in your system.\n| **Key Point:** Message data will be merged with data that has already been pushed. Therefore, you only need to push new or changed data.\n\nUse the following guidelines when sending messages:\n\n- Use the self-serve tool in the\n [Hotel Center Price Settings page](//hotelcenter.google.com/prices/settings)\n to add or update your IP addresses in our system.\n\n- Use the following base path for the endpoint:\n\n - `https://www.google.com` or `Host: www.google.com Port: 443`\n- Send messages using the `HTTP POST` method.\n\n- Set the `Content-Type` header to `application/xml`.\n\n- There is an account-level maximum update rate of 400 messages per second.\n If you exceed this limit, an error code of\n [6032](/hotels/hotel-prices/dev-guide/feed-status-errors#6032) is returned.\n\n- Use the following paths depending on the data being updated:\n\n \u003e - `Transaction` (Property Data): `/travel/hotels/uploads/property_data`\n \u003e - `OTA_HotelRateAmountNotifRQ`: `/travel/hotels/uploads/ota/hotel_rate_amount_notif`\n \u003e - `OTA_HotelAvailNotifRQ`: `/travel/hotels/uploads/ota/hotel_avail_notif`\n \u003e - `OTA_HotelInvCountNotifRQ`: `/travel/hotels/uploads/ota/hotel_inv_count_notif`\n \u003e - `TaxFeeInfo`: `/travel/hotels/uploads/taxes`\n \u003e - `Promotions`: `/travel/hotels/uploads/promotions`\n \u003e - `RateModifications`: `/travel/hotels/uploads/rate_modifications`\n \u003e - `ExtraGuestCharges`:`/travel/hotels/uploads/extra_guest_charges`\n\nFor each request message received, Google will respond with an `HTTP 200 OK`\nif the connection to the server succeeded and include a body with a response\nmessage indicating whether updates were applied successfully or encountered\nwarnings or errors. If Google responds with an HTTP error code, resend the\nmessage. If the HTTP response body contains warnings or errors, they should be\nfixed before resending the message. You can also view issues encountered for\nspecific messages on the Feed Status page in [Hotel Center](https://hotelcenter.google.com).\n\nLive on Google (LoG)\n--------------------\n\nLive on Google (LoG) lets you display your hotels on Google websites.\nSince the default LoG value for a hotel is `true`, any new hotels will\nautomatically be displayed on Google.\n\nUse LoG to turn your properties on and off for ads and free booking links in\nyour Hotel Center account, regardless of the status of Google Ads or whether the\nproperty has rates on Google.\n| **Key Point:** LoG is available for both Hotels and Vacation Rentals.\n\nThere are two ways to set a hotel's LoG value: the 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\npage](//hotelcenter.google.com/properties), 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](/hotels/hotel-prices/api-reference/Usage).\n\nFor more details about LoG, refer to the [Hotel Center\nHelp](//support.google.com/hotelprices/answer/10981242).\n\nUsing the Travel Partner API, you can do the following:\n\n- View the status of your properties through the Hotel Center or use the\n `hotelViews.list` endpoint.\n\n- Retrieve a list of all your hotels displayed on Google by using the `filter`\n parameter with `liveOnGoogle = TRUE` in `hotelViews.list` endpoint.\n\n- Get a summary of the properties for a specific account including the number\n of properties live on Google by using `hotelViews.summary`.\n\nFor more information about how to set LoG using the API, refer to the\n[`hotelViews.list`\narticle](/hotels/hotel-prices/api-reference/rest/v3/accounts.hotelViews/list)\nand the [API Reference](/hotels/hotel-prices/api-reference/Usage)."]]