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