نظرة عامة على ARI

"مدى التوفّر والأسعار والمستودع" (ARI) هو وضع لعرض الأسعار يتحكّم في الأسعار لكل ليلة ومدى التوفّر والمستودع، ويفرض قيودًا على كيفية الجمع بين هذه العناصر. توفّر ARI أيضًا المرونة اللازمة لتضمين الضرائب والرسوم والعروض الترويجية.

على عكس طُرق عرض الأسعار المستندة إلى برامج الرحلات، لا يتم البحث في خلاصات ARI عن أسعار أو برامج رحلات محدّدة باستخدام طريقتَي Pull وChanged Pricing. بدلاً من ذلك، يمكنك إرسال الرسائل عندما يتضمّن نموذج التسعير بيانات جديدة أو معدَّلة، مثل التغييرات في تفاصيل الأسعار والقيود ومدى التوفّر.

المزايا

تقدّم ARI المزايا التالية:

  • كفاءة معدل نقل البيانات: تزيد كفاءة معدل نقل البيانات من خلال تقليل حجم البيانات التي يجب نقلها. من خلال إرسال بيانات مدى توفّر الفندق وأسعاره ومستودعه (ARI) كل ليلة وإرسال التغييرات المتزايدة فقط، يمكن أن تحسب Google الأسعار والتعديلات لمجموعة كبيرة من قيم الشراء المسبق ومدة الإقامة.

  • دقة الأسعار: تعمل هذه الميزة على تحسين دقة الأسعار من خلال استخدام نموذج حدث "إرسال عند التغيير" لتقديم تعديلات مباشرة.

  • تغطية أكبر للأسعار: يتم تحقيق تغطية أكبر للأسعار (عدد برامج الرحلات التي تتضمّن أسعارًا) من خلال استخدام بيانات تفصيلية يتم دمجها في برامج رحلات مختلفة.

  • المرونة: تتيح هذه الميزة مرونة أكبر في تقديم العروض الترويجية والحِزم.

  • سهولة الاستخدام: يتم نقل البيانات بطريقة تتوافق مع طريقة تخزينها على نظامك، ما يجنّبك الحاجة إلى احتساب الأسعار أو تخزينها مؤقتًا للعديد من برامج الرحلات.

أنواع رسائل الطلبات

يُطلق على رسائل ARI المُرسَلة إلى Google اسم رسائل "الطلب" في ARI. بعد ذلك، تعرض Google رسائل "الرد" التي تشير إلى النجاح أو الإخفاق.

تتّبع ARI البروتوكولات العادية الخاصة بـ OpenTravel Alliance (OTA) لبعض أنواع الرسائل الرئيسية التي تحدّد مدى التوفّر والمخزون.

تستخدم واجهة ARI رسائل الطلبات التالية:

  • Transaction (بيانات الموقع) تحدّد هذه السمة معلومات حول نوع الغرفة والحزمة (خطة الأسعار).

  • OTA_HotelRateAmountNotifRQ. تحدّد هذه السمة مبالغ معدّل الإشغال لكل تاريخ أو استنادًا إلى مدة الإقامة لكل منتج (نوع الغرفة ومجموعة خطط الأسعار) لنطاقات تواريخ محدّدة.

  • OTA_HotelAvailNotifRQ: تحدّد هذه السمة مدى التوفّر والقيود استنادًا إلى نوع الغرفة وخطط الأسعار. ويمكن أيضًا تعديل المستودع باستخدام هذه الرسالة، ولكن يُفضّل استخدام OTA_HotelInvCountNotifRQ.

  • OTA_HotelInvCountNotifRQ. تحدّد هذه السمة عدد الغرف المادية المتاحة للبيع.

  • استبدِل TaxFeeInfo. (اختيارية) بتعريف الضرائب والرسوم لكلّ فندق. هذه الرسالة غير مطلوبة إذا تم تحديد AmountAfterTax في الرسالة OTA_HotelRateAmountNotifRQ.

  • استبدِل Promotions. (اختياري) بتعريف الأسعار الترويجية لعمليات حجز وإقامات ومستخدمين معيّنين.

  • RateModifications. (اختياري) تحدّد هذه السمة قواعد تعديل الأسعار لعمليات حجز وإقامات ومستخدمين معيّنين.

  • ExtraGuestCharges. (اختياري) تحدّد هذه السمة كيفية ضبط الأسعار للأطفال والبالغين الإضافيين.

تحتوي كل رسالة على مجموعة فرعية من المعلومات التي تستخدمها Google لاحتساب الأسعار ومعلومات التوفّر المعروضة للمستخدمين عند البحث عن أماكنك المتاحة للحجز باستخدام تواريخ تسجيل وصول ومغادرة محددة وعدد الأشخاص المطلوب.

لمزيد من المعلومات حول ARI، يُرجى الرجوع إلى مرجع XML.

الرسائل الفورية

لتعديل معلومات مدى التوفّر والأسعار ومستودع الفندق، أرسِل الرسائل المرتبطة بها كلما تغيّرت البيانات في نظامك.

يُرجى اتّباع الإرشادات التالية عند إرسال الرسائل:

  • استخدِم أداة الخدمة الذاتية في صفحة إعدادات الأسعار في Hotel Center لإضافة عناوين 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 يتضمّن تحذيرات أو أخطاء، يجب إصلاحها قبل إعادة إرسال الرسالة. يمكنك أيضًا الاطّلاع على المشاكل التي واجهتها رسائل معيّنة في صفحة "حالة الخلاصة" ضمن Hotel Center.

العرض على Google (LoG)

تتيح لك ميزة "مباشر على Google" عرض فنادقك على مواقع Google الإلكترونية. بما أنّ قيمة LoG التلقائية لأي فندق هي true، سيتم تلقائيًا عرض أي فنادق جديدة على Google.

استخدِم LoG لتفعيل مواقعك أو إيقافها للإعلانات وروابط الحجز المجانية في حسابك على Hotel Center، بغض النظر عن حالة "إعلانات 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.

لمزيد من التفاصيل حول LoG، يُرجى الرجوع إلى مساعدة Hotel Center.

استخدام Travel Partner API, you can do the following:

  • يمكنك الاطّلاع على حالة مواقعك من خلال Hotel Center أو استخدام نقطة النهاية hotelViews.list.

  • يمكنك استرداد قائمة بجميع الفنادق المعروضة على Google باستخدام المَعلمة filter مع liveOnGoogle = TRUE في نقطة النهاية hotelViews.list.

  • يمكنك الحصول على ملخّص للمواقع الخاصة بحساب معيّن، بما في ذلك عدد المواقع النشطة على Google، باستخدام hotelViews.summary.

لمزيد من المعلومات حول كيفية ضبط LoG باستخدام واجهة برمجة التطبيقات، يُرجى الرجوع إلى hotelViews.list المقالة ومرجع واجهة برمجة التطبيقات.