پیام‌های «درخواست خوانایاری»

یکی از راه‌های پیاده‌سازی فید قیمت، استفاده از قیمت تغییریافته (قبلاً Pull with Hints) است.

جریان این روش به‌صورت زیر است:

1. Google پیام «درخواست خوانایاری» را از عنصر ریشه <HintRequest> که حاوی اطلاعات زمانی از جدیدترین به‌روزرسانی سرور شما است ارسال می‌کند.

2. سرور شما با پیام «پاسخ خوانایاری»، <Hint>، پاسخ می‌دهد که حاوی فهرستی از قیمت‌های هتل است که از آخرین به‌روزرسانی تغییر کرده‌اند.

3. سپس Google با یک پیام پرسمان پاسخ می‌دهد: <Query>.

4. سرور شما با پیام تراکنش، <Transaction>، که شامل داده‌های به‌روزشده است، پاسخ می‌دهد.

برای نمای کلی قیمت‌گذاری مجدد، به فرایند قیمت‌گذاری مجدد مراجعه کنید.

Google به‌طور پیش‌فرض در فاصله‌های زمانی ۵ دقیقه‌ای پیام «درخواست خوانایاری» به سرور شما ارسال می‌کند. این بسامد را می‌توان با تنظیم تماس با ما اصلاح کرد.

پیام درخواست بااستفاده از روش HTTP POST ارسال می‌شود و سرصفحه Content-Type روی application/xml و سرصفحه User-Agent روی Google-HotelAdsPrices تنظیم شده است. با تماس با «مدیر فنی حساب» (TAM) خود، مطمئن شوید وضعیت نقطه پایانی که 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 پُرسمان و راهنمایی مراجعه کنید.