اگر محدودیتهای سیستمی دارید که شما را از حمایت از روشهای تحویل Pull یا Pull with Hints منع میکند، لطفاً از فرم تماس با ما استفاده کنید.
نمای کلی از حالت تحویل فشار
با حالت تحویل فشاری، هر زمان که قیمتها یا در دسترس بودن تغییر کند، بهروزرسانیهای افزایشی را ارسال میکنید.
تصویر زیر جریان درخواست/پاسخ را برای حالت تحویل فشاری نشان میدهد:
پیکربندی Push در فایل پیکربندی پروتکل
برای بهروزرسانی قیمتها با حالت تحویل فشاری، عناصر زیر را در فایل پیکربندی پروتکل خود مشخص کنید. این کار را فقط زمانی انجام می دهید که برای اولین بار محیط خود را برای کار با Hotel Prices API پیکربندی کنید:
-
<Model>
: مقدار عنصر<Model>
را روی "push" تنظیم کنید. -
<WhitelistedIPs>
: آدرسهای IP شما را که برای احراز هویت ارتباط بین شما و Google استفاده میکنید فهرست میکند. مقدار این عنصر میتواند فهرستی از آدرسهای IP شما به صورت نیمدوره جدا شده یا طیفی از آدرسهای IP با نماد CIDR باشد. این به شکل xxx.xxx.xxx.xxx/YY است.
مثال زیر یک فایل پیکربندی پروتکل را برای شرکای که از Push استفاده می کنند نشان می دهد:
<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
<Model>push</Model>
<WhiteListedIPs>216.239.32.0/19;64.233.160.0/19</WhiteListedIPs>
</Configuration>
برای اطلاعات بیشتر، به فایل پیکربندی پروتکل مراجعه کنید.
به روز رسانی قیمت ها با Push
برای بهروزرسانی دادههای خود با Push، هر زمان که دادههایتان تغییر کرد، یک پیام تراکنش ارسال کنید.
هنگام ارسال پیام تراکنش از دستورالعمل های زیر استفاده کنید:
- پیام را به نقطه پایانی زیر ارسال کنید:
-
http://www.google.com/travel/hotels/uploads/price
-
- از روش HTTP POST استفاده کنید.
- هدر
Content-Type
روی "application/xml" تنظیم کنید. - متن پیام باید مطابق با نحو پیام تراکنش باشد، همانطور که در تنظیمات قیمت (برای بهروزرسانی قیمتها) یا تعریف فراداده اتاق و بسته (برای بهروزرسانیهای فراداده) توضیح داده شده است.
- برای بهروزرسانیهای قیمت، برای هر برنامه سفری که میخواهید بهروزرسانی کنید، یک عنصر
<Result>
تعریف کنید. برای بهروزرسانیهای ابرداده، دادههای اتاق و دادههای بسته را برای هر ویژگی که تغییر کرده است تعریف کنید.
برای هر پیام تراکنشی که دریافت می کند، Google با یک پیام HTTP 200 OK
از سرور پاسخ می دهد تا موفقیت را نشان دهد. اگر Google با کد خطای HTTP پاسخ داد، پیام تراکنش را دوباره ارسال کنید. اگر هنگام ارسال یا دریافت پیام با مشکل مواجه شدید، به فیدهای عیب یابی مراجعه کنید.
شما باید برای هر برنامه سفر (ترکیب ملک/تاریخ ورود/مدت اقامت) که در آن قیمت تغییر کرده است، یک پیام تراکنش ارسال کنید. شما می توانید حداکثر 5 پیام تراکنش در ثانیه ارسال کنید. Google پیامهایی را که بیشتر از 5 در ثانیه ارسال میشوند مسدود نمیکند، اما ممکن است پیام شما در انتظار تکمیل درخواستهای دیگر تمام شود.
برای کاهش ترافیک شبکه، می توانید چندین عنصر <Result>
را در یک پیام تراکنش ترکیب کنید.
Google معمولاً قیمتهای بهروزرسانیشده و دادههای دردسترس بودن شما را تقریباً در ۵ دقیقه پردازش میکند. قیمت ها بعد از 90 روز حذف خواهند شد.
برای اطلاعات بیشتر در مورد استفاده از پیامهای تراکنش برای بهروزرسانی قیمتها، به تنظیم قیمتها مراجعه کنید.
بهروزرسانی فراداده اتاق و بسته با Push
برای بهروزرسانی فراداده اتاق و بسته، بهروزرسانیها را مانند هر بهروزرسانی دیگری ارسال کنید. در این مورد، شما یک پیام تراکنش با اطلاعات جدید در عناصر <RoomData>
و <PackageData>
ارسال می کنید. این عناصر فرزندان عنصر <PropertyDataSet>
هستند.
برای اطلاعات بیشتر، به تعریف فراداده اتاق و بسته مراجعه کنید.
خطاهای حالت تحویل
اگر هنگام ارسال پیام تراکنش به Google، خطای HTTP دریافت کردید، در فواصل زمانی 1، 5 و 20 دقیقه ای درخواست را دوباره امتحان کنید. اگر بعد از 3 بار تلاش مجدد مشکل ادامه داشت، ارسال پیام را متوقف کنید و با مدیر حساب Google خود تماس بگیرید.
وقتی با مدیر حساب Google خود تماس می گیرید تا خطای HTTP را که هنگام ارسال پیام تراکنش دریافت کرده اید گزارش کنید، Google در حین کار با شما آزمایشاتی را برای تقریباً 10 هتل اجرا می کند تا تأیید کند فیدهای شما به درستی پیکربندی شده اند. اگر آزمایشها موفقیتآمیز باشند، Google مجموعه کامل هتلهای مشخصشده در فید قیمت هتلهای شما را میخزد. این تضمین می کند که بارها قابل قبول هستند و قیمت های شما برای 3 تا 5 روز دقیق باقی می مانند. پس از این، گوگل شما را از راه اندازی مطلع می کند که در آن مرحله می توانید به نتایج خود به صورت زنده مراجعه کنید.
قیمت ها در چه فرکانسی باید فشار داده شود؟
در حالت ایدهآل، به محض اینکه متوجه شدید قیمت تغییر کرده است، همه بهروزرسانیها را انجام میدهید. اگر نمیدانید قیمتها چه زمانی تغییر کردهاند، باید سعی کنید تا حد امکان قیمتها را بهروز نگه دارید. این معمولا شامل فشارهای متعدد در روز می شود. به طور معمول، برنامه های سفر برای روز و هفته جاری بسیار بیشتر انجام می شود.