عندما يرسل محرّك بحث Google رسالة طلب تلميح، يجب أن تردّ خوادمك برسالة ردّ تتضمّن تلميحًا يحدّد الفنادق التي تغيّرت أسعارها منذ آخر مرة تلقّى فيها محرّك بحث Google ردًّا ناجحًا يتضمّن تلميحًا من تلك الخوادم نفسها. في حال حدوث أي تغييرات في الأسعار، ترسل Google <Query> يجلب بيانات الأسعار المعدَّلة للفنادق وبرامج الرحلات المحدّدة.
للحصول على نظرة عامة حول عملية إعادة التسعير، يُرجى الاطّلاع على نظرة عامة حول الأسعار.
تستخدِم رسائل "الردّ على التلميح" الطرق التالية لإعادة تسعير الفنادق المحدّدة وبرامج رحلاتها:
عنصر الجذر لرسالة ردّ على طلب قائمة بالتعديلات هو <Hint>. يمكنك طلب تعديل فندق أو خطة سفر باستخدام عنصر واحد أو أكثر من عناصر <Item>. يمكن لرسالة Hint
Response واحدة تحديد أي عدد من عناصر <Item>.
يجب أن تحدّد كل رسالة Hint Response عنصر <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
مسار الطلب والاستجابة لنطاقات تواريخ تسجيل الوصول
يمكن لرسالة Hint Response تحديد نطاق من تواريخ تسجيل الوصول، بدءًا من أول تاريخ تسجيل وصول وانتهاءً بآخر تاريخ تسجيل وصول. عندما تسترد Google بيانات الأسعار الجديدة، فإنّها تسترد برامج الرحلات لكل تاريخ تسجيل وصول في الفندق، بدءًا من تلك التواريخ وحتى مدة الإقامة التي تحدّدها.
التواريخ المحدّدة من الشريك
يحدّد المثال التالي لرسالة "الردّ على التلميح" سمة واحدة تتضمّن نطاقًا من التواريخ لتسجيل الوصول:
<Hint>
<Item>
<Property>12345</Property>
<FirstDate>2023-05-20</FirstDate>
<LastDate>2023-05-23</LastDate>
</Item>
</Hint>
ردّ Google
تردّ Google على رسالة Hint Response هذه باستخدام <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