نظرة عامة على رسائل المعاملات

ترسل رسائل المعاملات بيانات حول الغرف والأسعار والحِزم إلى Google. هناك نوعان أساسيان من رسائل المعاملات:

1. بيانات برنامج الرحلة: تحديد حزمة الغرف وبيانات برنامج الرحلة، بما في ذلك:

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

   • حِزم الغرف: اضبط أسعار برامج الرحلات لمجموعة من الغرف المادية وحزمة من الخدمات الإضافية. لمزيد من المعلومات، يُرجى الاطّلاع على حِزم الغرف. يحتفظ محرّك بحث Google بنسخة مؤقتة من محتوى رسائل المعاملات لكي تكون الأسعار متاحة في جميع الأوقات. في بعض الحالات، ترى Google أنّ القيم المخزّنة مؤقتًا غير محدّثة، لذا قد ترسل رسائل <Query> إضافية (أو طلبات البحث عن الأسعار المباشرة في بعض الحالات) للحصول على أسعار محدّثة. وعادةً ما تتغيّر هذه البيانات بشكل متكرّر جدًا. لتحديد السعر ومدى توفّر رسائل المعاملات، استخدِم <Result>.

2. البيانات الوصفية للغرف والحِزم: تحدّد تفاصيل حول الغرف والحِزم، مثل الأوصاف والصور والحد الأقصى لعدد النزلاء. ولا تتغيّر هذه البيانات كثيرًا. لتحديد البيانات الوصفية لرسائل المعاملات، استخدِم <PropertyDataSet>. تخزّن Google هذه البيانات الوصفية لتتمكّن من الرجوع إليها من رسائل الأسعار بدلاً من تضمين معلومات متكرّرة حول الغرف والحِزم في كل رسالة. لمزيد من المعلومات، يُرجى الاطّلاع على تحديد البيانات الوصفية للغرف والحِزم.

العنصر الجذر لرسالة المعاملة هو <Transaction>. تتطلّب الرسائل التي تستخدم العنصر <Transaction> كعنصر جذر واحدًا على الأقل من العناصر الفرعية. يمكن أن تحتوي رسائل المعاملات على أي عدد من العناصر الفرعية، طالما أنّ إجمالي حجم الرسالة لا يتجاوز 100 ميغابايت.

للاطّلاع على أمثلة على رسائل المعاملات التي تستجيب لطلبات Google، يُرجى الرجوع إلى مرجع XML للتسعير وتوفّر الغرف (المعاملات).

طُرق العرض

يعتمد نوع الرسائل المتعلقة بالمعاملات وعدد مرات إرسالها على وضع التسليم:

• في وضع التسليم "سحب"، يتم إرسال رسائل المعاملات عند تلقّي <Query> من Google.
• بالنسبة إلى وضع التسليم "الأسعار المتغيرة"، عليك إرسال رسالة "معاملة" بعد تلقّي الرد على <HintRequest> و<Query>.

لمزيد من المعلومات، اطّلِع على طُرق عرض الأسعار.

طلبات البحث عن الأسعار في الوقت الفعلي

بغض النظر عن طريقة العرض، قد يرسل إليك Google أيضًا طلبات تُعرف باسم طلبات البحث عن الأسعار المباشرة. تطلب رسائل طلب البحث هذه الأسعار استجابةً لعملية بحث جارية. إذا استجبت خلال الإطار الزمني المحدّد الذي يبلغ عادةً بضع مئات من الملّي ثانية، يمكن أن يظهر إعلانك في المزاد. يمكن أن تتطابق نتائجك أيضًا بشكل أفضل مع العميل، بما في ذلك البلد ونوع الجهاز وعدد الضيوف الذي حدّده. لمزيد من المعلومات، يُرجى الاطّلاع على طلبات البحث عن الأسعار المباشرة.

حجم الرسالة

يمكنك تضمين أي مجموعة من تحديثات البيانات في رسالة معاملة واحدة، ولكن هناك حد أقصى يبلغ 100 ميغابايت لحجم كل رسالة. عادةً، يكون الحد الأقصى لمدة الرد على جميع طلبات السحب وطلبات التلميح 100 ثانية. المهلة هي حقل قابل للضبط يمكن أن تعدّله Google حسب الطلب. تنصح Google بضبط المهلة على 10 دقائق للرسائل الكبيرة جدًا.

لتقليل حجم الرسالة بشكل كبير وتجنُّب المشاكل المحتملة المتعلّقة بأحجام الرسائل والمهلات، استخدِم رسائل المعاملات لتحديد بيانات وصف الغرفة والحزمة مسبقًا. يمكنك أيضًا إضافة محتوى مضغوط بتنسيق GNU إلى الرسائل من خلال إضافة Content-Encoding: gzip إلى رؤوس الرسائل.