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

عندما ترسل 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 بيانات الأسعار الجديدة، تستردّ مسارات الرحلة لكل تاريخ تسجيل وصول للفندق بدءًا من تلك التواريخ وتمتدّ حتى مدة الإقامة التي تحدّدها.

النطاقات الزمنية لتاريخ تسجيل الوصول من الشريك

يحدّد المثال التالي لرسالة "الردّ على طلب قائمة بالتعديلات" موقعًا واحدًا يتضمّن نطاقًا زمنيًا لتاريخ تسجيل الوصول:

<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