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

عندما ترسل 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 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>
  <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