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

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

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

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

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

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

مسار طلب برنامج الرحلة الدقيق والاستجابة له

يمكن أن تستند رسائل التلميح إلى برامج رحلات فردية، مثل combination of تاريخ تسجيل الوصول ومدة الإقامة. في هذه الحالة، يمكنك تحديد تاريخ تسجيل الوصول و مدة الإقامة في الفنادق، وستسترجع 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 ليالٍ. مدة الإقامة التلقائية هي 30 يومًا.

مسار طلب وتلقّي استجابة بشأن الإقامة ضمن نطاق سعري

يمكن أن تتضمّن رسالة "الردّ على التلميح" نطاقًا من التواريخ التي تغيّرت. يُعلم ذلك 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