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

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

للحصول على نظرة عامة حول عملية إعادة التسعير، اطّلِع على نظرة عامة على الأسعار.

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

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

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

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

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

ردّ الشريك

تحدد رسالة رد التلميح التالية موقعًا واحدًا ومسارًا واحدًا:

<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>
  <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>
  <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