تُرسِل رسائل المعاملات بيانات عن الغرف والأسعار والحزم إلى Google. هناك نوعان أساسيان من رسائل المعاملات:
بيانات برنامج الرحلة: حدِّد بيانات حزمة الغرف وبرنامج الرحلة، بما في ذلك:
أسعار الفنادق والمستودع: يمكنك ضبط الحد الأدنى لسعر برنامج رحلة يستوفي متطلبات معيّنة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تعديل الأسعار. يمكنك أيضًا إزالة غرفة من المستودع. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إزالة المستودع الإعلاني.
حِزم الغرف: يمكنك ضبط أسعار برنامج الرحلة لتشمل هُندسة ملف شخصي غرفة وحزمة من الخدمات الإضافية. لمزيد من المعلومات، يُرجى الاطّلاع على حِزم الغرف. تحتفظ Google بنسخة مؤقتة من محتوى رسائل المعاملات لكي تكون الأسعار متوفرة في جميع الأوقات. في بعض الحالات، تحدّد Google أنّ القيم في ذاكرة التخزين المؤقت غير محدّثة، لذا قد ترسل رسائل
<Query>إضافية (أو في بعض الحالات، طلبات بحث عن الأسعار في الوقت الفعلي) للحصول على أسعار محدّثة. تتغيّر هذه البيانات عادةً بشكلٍ متكرّر جدًا. لتحديد أسعار رسائل المعاملات ومدى توفّرها، استخدِم<Result>.
البيانات الوصفية للغرف والحزم: تحدّد تفاصيل عن الغرف والحزم، مثل الأوصاف والصور والحد الأقصى لعدد النزلاء. لا تتغيّر هذه البيانات كثيرًا. لتحديد البيانات الوصفية لرسائل المعاملات، استخدِم
<PropertyDataSet>. تخزّن Google هذه البيانات الوصفية لكي تتمكّن من الرجوع إليها من رسائل الأسعار بدلاً من تضمين معلومات متكرّرة عن الغرف والحزم في كل رسالة. لمزيد من المعلومات، يُرجى الاطّلاع على تحديد البيانات الوصفية للغرفة والحزمة.
العنصر الجذر لرسالة المعاملات هو <Transaction>. إنّ الرسائل التي تستخدِم العنصر
<Transaction> كعنصر الجذر تتطلّب عنصرًا فرعيًا واحدًا على الأقل. يمكن أن تحتوي رسائل المعاملات على أي عدد من العناصر الفرعية، ما دام إجمالي حجم الرسالة لا يتجاوز 100 ميغابايت.
للحصول على أمثلة على رسائل المعاملات التي تستجيب لطلبات Google، يُرجى الاطّلاع على مرجع XML للأسعار ومستودع الغرف (المعاملات).
طرق العرض
يعتمد نوع رسائل المعاملات ومعدّل إرسالها على وضع التسليم:
- في وضع التسليم من خلال سحب البيانات، تُرسِل رسائل المعاملات عند تلقّي
<Query>من Google. - بالنسبة إلى وضع تسليم "الأسعار المتغيّرة"، يمكنك إرسال رسالة معاملة
بعد تلقّي رسالتَي
<HintRequest>و<Query>والردّ عليهما.
لمزيد من المعلومات، يُرجى الاطّلاع على طرق عرض الأسعار.
طلبات البحث عن الأسعار في الوقت الفعلي
بغض النظر عن وضع العرض، قد ترسل إليك Google أيضًا طلبات تُعرف باسم طلبات البحث عن الأسعار في الوقت الفعلي. تبحث رسائل طلبات البحث هذه عن الأسعار استجابةً لبحث حالي. إذا رددت في الإطار الزمني المحدّد الذي يتراوح عادةً بين بضع مئات من المللي ثانية، يمكن أن يظهر إعلانك في المزاد. يمكن أن تتطابق نتائجك أيضًا بشكل أفضل مع العميل، بما في ذلك بلده و نوع جهازه وعدد النزلاء الذين حدّدهم. لمزيد من المعلومات، يمكنك الاطّلاع على طلبات البحث عن الأسعار المباشرة.
حجم الرسالة
يمكنك تضمين أي مجموعة من تعديلات البيانات في رسالة معاملة واحدة، ولكن هناك حد أقصى يبلغ 100 ميغابايت لحجم كل رسالة. عادةً ما يكون الحدّ الأقصى لمدة الردّ على جميع طلبات Pull و Hint هو 100 ثانية. مهلة الانتظار هي حقل قابل للضبط يمكن لشركة Google تعديله حسب الطلب. تنصح Google بتحديد مهلة 10 دقائق للرسائل الكبيرة جدًا.
لتقليل حجم الرسائل بشكل كبير وتجنُّب المشاكل المحتملة المتعلّقة بحجم الرسائل والوقت المنقضي، استخدِم رسائل المعاملات لتحديد
البيانات الوصفية للغرفة والحزمة مسبقًا.
يمكنك أيضًا إضافة محتوى مضغوط بتنسيق GNU إلى الرسائل من خلال إضافة
Content-Encoding: gzip إلى رؤوس الرسائل.