رسائل لطلب قائمة بالتعديلات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إحدى طرق تنفيذ خلاصة الأسعار هي استخدام التغيير في السعر (المعروف سابقًا باسم Pull
with Hints).
في ما يلي خطوات هذه الطريقة:
تُرسِل Google رسالة طلب تلميح من العنصر الجذر <HintRequest>
التي تحتوي على معلومات الوقت من آخر تعديل على الخادم.
يردّ الخادم برسالة ردّ على طلب قائمة بالتعديلات، <Hint>،
التي تحتوي على قائمة بأسعار الفنادق التي تغيّرت منذ
آخر تعديل.
تردّ Google بعد ذلك من خلال رسالة طلب: <Query>.
يردّ الخادم برسالة
Transaction message (رسالة المعاملة)،
<Transaction>، التي تتضمّن البيانات المعدَّلة.
للحصول على نظرة عامة عن إعادة التسعير، يُرجى الاطّلاع على عملية إعادة التسعير.
ترسل Google رسالة طلب قائمة بالتعديلات إلى خادمك على فترات زمنية تبلغ 5 دقائق بشكلٍ
تلقائي. ويمكن تعديل معدّل التكرار هذا من خلال التواصل معنا.
يتم إرسال رسالة الطلب باستخدام طريقة POST في HTTP مع ضبط العنوان Content-Type
على application/xml وضبط العنوان User-Agent على
Google-HotelAdsPrices. تأكَّد من أنّ حالة نقطة النهاية التي ترسلها Google هي OK من خلال
التواصل مع المدير الفني لحسابك. من المفترض أن تكون قد ضبطت هذا الإعداد أثناء
الإعداد الأولي لأسعار الفنادق.
مثال على طلب قائمة بالتعديلات
تحتوي رسائل طلب التعديلات على عنصر جذر هو
<HintRequest> وعنصر فرعي واحد هو <LastFetchTime>.
<?xml version="1.0" encoding="UTF-8"?>
<HintRequest id="request" timestamp="2023-06-03T22:59:48Z">
<LastFetchTime>2023-06-03T22:54:40Z</LastFetchTime>
</HintRequest>
لمزيد من الأمثلة والمعلومات الإضافية، يُرجى الرجوع إلى مرجع XML للطلبات والاقتراحات.
جميع الحقوق محفوظة. إنّ Java علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle's Changed Pricing method allows you to update hotel prices efficiently by focusing on changes since the last update.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves a Hint Request from Google, a Hint Response from your server with changed hotel IDs, a Query from Google, and a Transaction from your server with updated data.\u003c/p\u003e\n"],["\u003cp\u003eGoogle sends Hint Requests every 5 minutes, but this frequency can be adjusted by contacting Google support.\u003c/p\u003e\n"],["\u003cp\u003eHint Requests use HTTP POST with specific headers; ensure endpoint status is "OK" for successful communication.\u003c/p\u003e\n"],["\u003cp\u003eHint Request messages contain the last fetch time, allowing your server to identify price changes since then.\u003c/p\u003e\n"]]],[],null,["# Hint Request Messages\n\nOne way to implement your price feed is to use [Changed Pricing (formerly Pull\nwith Hints)](/hotels/hotel-prices/dev-guide/delivery-mode#hints).\n\nThe flow for this method is as follows:\n\n1. Google sends a Hint Request message from the root element [`\u003cHintRequest\u003e`](../xml-reference/queries#hintrequest)\n that contains time information from your most recent server update.\n\n2. Your server responds with a [Hint Response\n message](/hotels/hotel-prices/dev-guide/hint-response-messages), [`\u003cHint\u003e`](../xml-reference/queries#Hint),\n which contains a list of hotels prices that have changed since\n the last update.\n\n3. Google then responds with a\n [Query message](/hotels/hotel-prices/dev-guide/query-messages): [`\u003cQuery\u003e`](../xml-reference/queries#Query).\n\n4. Your server responds with a\n [Transaction message](/hotels/hotel-prices/dev-guide/transaction-overview),\n [`\u003cTransaction\u003e`](../xml-reference/transaction-messages#Transaction), that includes the updated data.\n\nFor an overview of repricing, see [Repricing\nprocess](/hotels/hotel-prices/dev-guide/updating-prices#repricing-process).\n\nGoogle sends a Hint Request message to your server at 5-minute intervals by\ndefault. This frequency can be adjusted by setting [contact us](https://support.google.com/hotelprices/gethelp).\n\nThe request message is sent using an HTTP `POST` method with the `Content-Type`\nheader set to `application/xml` and the `User-Agent` header set to\n`Google-HotelAdsPrices`. Ensure the endpoint status that Google sends back is `OK` by\ncontacting your Technical Account Manager (TAM). You should have configured this setting during your\nHotel Prices initial setup.\n\n### Hint Request example\n\nHint Request messages have a root element of\n[`\u003cHintRequest\u003e`](../xml-reference/queries#hintrequest) and a single child element, `\u003cLastFetchTime\u003e`. \n\n \u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n \u003cHintRequest id=\"request\" timestamp=\"2023-06-03T22:59:48Z\"\u003e\n \u003cLastFetchTime\u003e\u003cvar translate=\"no\"\u003e2023-06-03T22:54:40Z\u003c/var\u003e\u003c/LastFetchTime\u003e\n \u003c/HintRequest\u003e\n\nFor more examples and additional information, refer to [Query \\& Hints XML Reference](../xml-reference/queries)."]]
