تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مدى التوفّر والأسعار والمستودع الإعلاني (ARI) هو وضع عرض أسعار يتحكم في أسعار الإقامة في الليلة والمستودع الإعلاني ومدى التوفّر، ويفرض قيودًا على كيفية دمج هذه العناصر. توفّر ARI أيضًا مرونة في تضمين الضرائب والرسوم
والعروض الترويجية.
كفاءة معدل نقل البيانات: تزيد كفاءة معدل نقل البيانات عن طريق تقليل
حجم البيانات التي يجب نقلها. من خلال إرسال بيانات ARI كل ليلة و
التغييرات المتزايدة فقط، يمكن لخدمة Google احتساب الأسعار والتعديلات على نطاق واسع
من قيم الشراء المُسبَق وطول الإقامة.
دقة الأسعار: تعمل هذه الميزة على تحسين دقة الأسعار باستخدام نموذج حدث push-on-change
لعرض آخر المعلومات مباشرةً.
تغطية أكبر للأسعار: يمكنك تحقيق تغطية أكبر للأسعار (عدد خطط الرحلة التي تتضمّن أسعارًا) باستخدام بيانات دقيقة يتم دمجها في خطط رحلة مختلفة.
المرونة: تتيح هذه الطريقة مرونة أكبر في تقديم العروض الترويجية والحِزم.
سهولة الاستخدام: يتم نقل البيانات بطريقة تتوافق مع كيفية تخزينها على نظامك، ما يجنبك الحاجة إلى احتساب الأسعار أو تخزينها مؤقتًا في ملف ذاكرة التخزين المؤقت لرحلات عديدة.
أنواع رسائل الطلبات
تُعرف رسائل ARI المُرسَلة إلى Google باسم رسائل "طلب" ARI. بعد ذلك، تُرسِل Google
رسائل "استجابة" تشير إلى النجاح أو الفشل.
تتّبع ARI بروتوكولات OpenTravel Alliance (OTA) العادية لبعض
أنواع الرسائل الرئيسية لتحديد مدى التوفّر والمستودع.
OTA_HotelRateAmountNotifRQ:
تُحدِّد هذه السمة مبالغ سعر الإقامة لكل منتج (نوع
الغرفة ومجموعة الأسعار) استنادًا إلى كل تاريخ أو مدة إقامة محددة.
OTA_HotelAvailNotifRQ:
تحدّد مدى التوفّر والقيود استنادًا إلى نوع الغرفة وخطط الأسعار.
يمكن أيضًا تعديل المستودع باستخدام هذه الرسالة، ولكن يُفضّل استخدام OTA_HotelInvCountNotifRQ.
TaxFeeInfo:
(اختيارية) لتحديد الضرائب والرسوم لكل موقع هذه الرسالة غير مطلوبة
إذا تم تحديد AmountAfterTax في رسالة OTA_HotelRateAmountNotifRQ.
Promotions.
(اختياري) لتحديد الأسعار الترويجية لحجوزات وإقامة و
مستخدمين معيّنين.
RateModifications.
(اختياري) لتحديد قواعد تعديل الأسعار لبعض الحجوزات والإقامة
والمستخدمين.
ExtraGuestCharges.
(اختياري) يحدِّد كيفية ضبط الأسعار للأطفال و
البالغين الإضافيين.
تحتوي كل رسالة على مجموعة فرعية من المعلومات التي تستخدمها Google لاحتساب
الأسعار ومدى التوفّر المعروضَين للمستخدمين عند البحث عن مواقعك
مع تواريخ تسجيل الدخول والمغادرة المحدّدة وعدد النزلاء المطلوب.
لمزيد من المعلومات عن ARI، يُرجى الرجوع إلى
مرجع XML.
الرسائل الفورية
لتعديل معلومات مدى توفّر الفندق وأسعاره ومستودعه (ARI) ومعلومات الفندق، أرسِل الرسائل المرتبطة بها كلّما حدث تغيير في
البيانات في نظامك.
لكل رسالة طلب يتم استلامها، ستستجيب Google باستخدام HTTP 200 OK
إذا تم الاتصال بالخادم بنجاح، وستتضمّن نصًا يحتوي على رسالة
استجابة تشير إلى ما إذا تم تطبيق التعديلات بنجاح أو تم العثور على
تحذيرات أو أخطاء. إذا ردّت Google برمز خطأ HTTP، يُرجى إعادة إرسال
الرسالة. إذا كان نصّ استجابة HTTP يتضمّن تحذيرات أو أخطاء، يجب أولاً
إصلاحها قبل إعادة إرسال الرسالة. يمكنك أيضًا الاطّلاع على المشاكل التي واجهتها في
رسائل معيّنة في صفحة "حالة الخلاصة" في Hotel Center.
البثّ المباشر على Google (LoG)
تتيح لك ميزة "الإقامة على Google" عرض فنادقك على مواقع Google الإلكترونية.
بما أنّ القيمة التلقائية لـ LoG الخاصة بالفندق هي true، سيتم تلقائيًا
عرض أي فنادق جديدة على Google.
استخدِم ميزة "إدارة الموافقة" لتفعيل مواقعك وإيقافها للإعلانات وروابط الحجز المجانية في حسابك على
"مركز إدارة معلومات الفنادق"، بغض النظر عن حالة "إعلانات Google" أو ما إذا كان
الفندق يعرض أسعارًا على 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.
جميع الحقوق محفوظة. إنّ Java علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)."]]
