رسائل ردّ على طلب قائمة بالتعديلات

عندما ترسل Google رسالة "طلب التلميح"، يجب أن تردّ خوادمك برسالة Hint Response (الاستجابة للطلب) تحدّد الفنادق التي تغيّرت أسعارها منذ آخر مرة تلقّت فيها Google "رد تلميح" ناجحًا من الخوادم نفسها. إذا طرأت أي تغييرات في الأسعار، سترسل Google بعد ذلك <Query> لجلب بيانات الأسعار المعدّلة للفنادق وبرامج الرحلات المُشار إليها.

لإلقاء نظرة عامة على عملية إعادة التسعير، يمكنك الاطّلاع على نظرة عامة على الأسعار.

نقطة رئيسية: في حال عدم تطبيق الأسعار المعدَّلة، تجلب Google بيانات جميع الفنادق في قائمة الفنادق.

تستخدم رسائل الردّ على التلميح الطرق التالية لإعادة تسعير الفنادق المحدّدة وبرامج رحلاتها:

• برامج الرحلات المحدَّدة
• النطاقات الزمنية لتسجيل الوصول
• الإقامات المصنّفة

ملاحظة: المدة التلقائية للإقامة باستخدام "السعر المُعدَّل" هي 5 أيام.

إنّ العنصر الجذر لرسالة Hint Response هو <Hint>. يمكنك طلب تعديل فندق أو برنامج رحلة باستخدام عنصر واحد أو أكثر من عناصر <Item>. ويمكن لرسالة Hint Response واحدة تحديد أي عدد من عناصر <Item>.

يجب أن تحدّد كل رسالة من رسالة Hint Response عنصر <Property> واحدًا على الأقل لكل <Item>. تحدّد السمة <Property> فندقًا باستخدام المعرّفات نفسها الواردة في قائمة الفنادق. بشكل تلقائي، يمكنك تحديد رقم تعريف فندق واحد لكل حظر <Item>. ومع ذلك، يمكنك توجيه Google للسماح بعدة فنادق في مجموعة سلع إذا كنت تستخدم النطاقات الزمنية لتسجيل الوصول أو إقامة ذات نطاق زمني محدّد لإعادة التسعير.

طلب برنامج الرحلة وتسلسل الاستجابة بالضبط

يمكن أن تستند رسائل التلميحات إلى برامج رحلات فردية، مثل تاريخ تسجيل الوصول ومدة الإقامة. في هذه الحالة، يمكنك تحديد تاريخ تسجيل الوصول ومدة الإقامة لفنادقك، وستجلب Google بيانات الأسعار الجديدة لبرنامج الرحلة هذا فقط.

رد الشريك

تحدّد رسالة Hint Response التالية سمة واحدة وخطًا واحدًا:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

ردّ Google

يردّ محرّك بحث Google على رسالة التلميح باستخدام <Query> على النحو التالي:

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

إنشاء <Transaction>

ويُتوقّع منك بعد ذلك إنشاء السمة <Transaction> تتضمّن تعديلات على أسعار الفندق للإقامة التالية:

5/20/23 - 5/23/23

طلب النطاقات الزمنية لتسجيل الوصول وتدفق الردّ

يمكن أن تحدد رسالة التلميح نطاقًا من تواريخ تسجيل الوصول، بدءًا من تاريخ تسجيل الوصول الأول وانتهاءً بتاريخ تسجيل الوصول الأخير. عندما تجلب Google بيانات أسعار جديدة، تسحب Google برامج الرحلات لكل تاريخ تسجيل وصول للفندق بدءًا من تلك التواريخ وتمتد حتى مدة الإقامة التي تشير إليها.

النطاقات الزمنية المحدّدة للشريك

يحدّد المثال التالي لرسالة Hint Response سمة واحدة مع نطاق من تواريخ تسجيل الوصول:

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

ردّ Google

يردّ محرّك بحث Google على رسالة التلميح هذه باستخدام <Query> على النحو التالي:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

إنشاء <Transaction>

بعد ذلك، من المتوقّع أن تنشئ <Transaction> يتضمّن تعديلات أسعار الإقامات التالية في هذا الفندق:

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/20/23 - 5/24/23
5/20/23 - 5/25/23

5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/21/23 - 5/25/23
5/21/23 - 5/26/23

5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/22/23 - 5/26/23
5/22/23 - 5/27/23

يستخدم هذا المثال المدة التلقائية للإقامة، وهي 5 ليالٍ.

طلب الإقامات بزاوية محدّدة ومسار الاستجابة

يمكن أن تتضمّن رسالة التلميح مجموعة من التواريخ التي تم تغييرها. يُعلم هذا الإجراء Google بضرورة استرجاع أي برنامج رحلة متأثر بأي من هذه التواريخ. إنّ المجموعة الفعلية من برامج الرحلات التي يتم جلبها هي دالة لكل من مجموعة التواريخ التي تتضمّن تغييرات والحد الأقصى لمدة الإقامة.

إقامات الشريك بنطاق زمني محدد

يستخدم المثال التالي رسالة Hint Response إقامة ذات نطاق:

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

ردّ Google

يردّ محرّك بحث Google على رسالة التلميح باستخدام <Query> على النحو التالي:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

إنشاء <Transaction>

بعد ذلك، نتوقّع منك إنشاء السمة <Transaction> تتضمّن تعديلات على أسعار الفندق للإقامة التالية:

5/17/23 - 5/20/23

5/18/23 - 5/20/23
5/18/23 - 5/21/23

5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23

5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23

5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23

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