تُرسِل رسائل المعاملات بيانات عن الغرف والأسعار والطرود إلى 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 إلى عناوين الرسائل.