نمای کلی ARI

در دسترس بودن، نرخ‌ها و موجودی (ARI) یک حالت تحویل قیمت است که نرخ‌های شبانه، در دسترس بودن و موجودی را کنترل می‌کند و محدودیت‌هایی را در مورد نحوه ترکیب این موارد ارائه می‌کند. ARI همچنین انعطاف‌پذیری را برای درج مالیات، هزینه‌ها و تبلیغات فراهم می‌کند.

برخلاف حالت‌های تحویل قیمت‌گذاری مبتنی بر برنامه سفر، قیمت‌گذاری کششی و تغییر یافته، فیدهای ARI برای قیمت‌ها یا برنامه‌های سفر خاص درخواست نمی‌شوند. در عوض، زمانی که مدل قیمت‌گذاری شما داده‌های جدید یا تغییر یافته دارد، مانند تغییرات در جزئیات نرخ، محدودیت‌ها و در دسترس بودن، پیام‌ها را ارسال می‌کنید.

فواید

ARI مزایای زیر را ارائه می دهد:

  • کارایی پهنای باند : با کاهش حجم داده هایی که باید ارسال شوند، کارایی پهنای باند را افزایش می دهد. با ارسال داده‌های ARI شبانه و فقط تغییرات تدریجی، Google می‌تواند قیمت‌ها و به‌روزرسانی‌ها را برای طیف گسترده‌ای از خریدهای اولیه و مقادیر مدت اقامت محاسبه کند.

  • دقت قیمت : دقت قیمت را با استفاده از مدل رویداد فشار بر تغییر برای ارائه به‌روزرسانی‌های زنده بهبود می‌بخشد.

  • پوشش قیمت بیشتر : با استفاده از داده های دانه ای که در برنامه های سفر مختلف ترکیب می شوند، به پوشش قیمت بالاتر (تعداد سفرها با قیمت ها) دست می یابد.

  • انعطاف پذیری : انعطاف پذیری بیشتری را با ارائه تبلیغات و بسته ها امکان پذیر می کند.

  • سهولت استفاده : داده ها را به گونه ای منتقل می کند که با نحوه ذخیره آن ها در سیستم شما هماهنگ باشد، و از نیاز به محاسبه یا ذخیره قیمت ها برای بسیاری از سفرها اجتناب می کند.

درخواست انواع پیام

پیام های ARI ارسال شده به Google به عنوان پیام های "درخواست" 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 و اطلاعات دارایی، هر زمان که داده ها در سیستم شما تغییر کرد، پیام های مرتبط را ارسال کنید.

هنگام ارسال پیام از دستورالعمل های زیر استفاده کنید:

  • از ابزار self-serve در صفحه تنظیمات قیمت هتل مرکز برای افزودن یا به روز رسانی آدرس های 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 حاوی اخطار یا خطا باشد، باید قبل از ارسال مجدد پیام رفع شود. همچنین می‌توانید مشکلات پیش‌آمده برای پیام‌های خاص را در صفحه وضعیت فید در مرکز هتل مشاهده کنید.

زنده در 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 .

برای جزئیات بیشتر درباره LoG، به راهنمای مرکز هتل مراجعه کنید.

با استفاده از Travel Partner API, you can do the following:

  • وضعیت املاک خود را از طریق مرکز هتل مشاهده کنید یا از نقطه پایانی hotelViews.list استفاده کنید.

  • با استفاده از پارامتر filter با liveOnGoogle = TRUE در نقطه پایان hotelViews.list ، فهرستی از تمام هتل های خود را که در Google نمایش داده شده است، بازیابی کنید.

  • با استفاده از hotelViews.summary خلاصه ای از دارایی های یک حساب خاص از جمله تعداد دارایی های فعال در Google را دریافت کنید.

برای اطلاعات بیشتر در مورد نحوه تنظیم LoG با استفاده از API، به مقاله hotelViews.list و مرجع API مراجعه کنید.