نمای کلی پیام‌های تراکنش

پیام‌های تراکنش داده‌های مربوط به اتاق‌ها، قیمت‌ها، و بسته‌ها را به Google ارسال می‌کنند. دو نوع اصلی «پیام تراکنش» وجود دارد:

  1. داده‌های برنامه سفر: «بسته ترکیبی اتاق» و داده‌های برنامه سفر را تعریف کنید، ازجمله:

    • قیمت‌ها و موجودی هتل: حداقل قیمت را برای برنامه سفری که الزامات خاصی را برآورده می‌کند تنظیم کنید. برای اطلاعات بیشتر، به به‌روزرسانی قیمت‌ها مراجعه کنید. همچنین می‌توانید اتاقی را از فهرست موجودی بردارید. برای اطلاعات بیشتر، به برداشتن موجودی مراجعه کنید.

    • بسته‌های ترکیبی اتاق: قیمت‌های برنامه سفر را برای ترکیبی از اتاق فیزیکی و بسته‌ای از خدمات اضافی تنظیم کنید. برای اطلاعات بیشتر، بسته‌های ترکیبی اتاق را ببینید. Google محتوای پیام‌های «تراکنش» شما را ذخیره می‌کند تا قیمت‌ها همیشه دردسترس باشند. در برخی موارد، Google تشخیص می‌دهد که مقادیر موجود در حافظه نهان آن به‌روز نیست، بنابراین ممکن است پیام‌های <Query> اضافی (یا در برخی موارد، پرس‌وجوهای قیمت‌گذاری زنده) ارسال کند تا قیمت‌های به‌روز را دریافت کند. این داده‌ها معمولاً به‌طور مکرر تغییر می‌کنند. برای تعریف قیمت‌گذاری و دردسترس بودن «پیام‌های تراکنش»، از <Result> استفاده کنید.

  2. فراداده اتاق و بسته: جزئیات مربوط به اتاق‌ها و بسته‌ها را مشخص می‌کند، مانند توضیحات، عکس‌ها، و حداکثر ظرفیت. این داده‌ها اغلب تغییر نمی‌کند. برای تعریف پیام‌های تراکنش فراداده، از <PropertyDataSet> استفاده کنید. Google این فراداده را ذخیره می‌کند تا بتوانید از پیام‌های قیمت‌گذاری‌تان به آن ارجاع دهید و مجبور نباشید اطلاعات تکراری درباره اتاق‌ها و بسته‌ها را در هر پیام بگنجانید. برای اطلاعات بیشتر، به تعریف فراداده اتاق و بسته مراجعه کنید.

عنصر ریشه «پیام تراکنش» <Transaction> است. پیام‌هایی که از عنصر <Transaction> به‌عنوان عنصر ریشه استفاده می‌کنند، به حداقل یکی از عناصر فرزند نیاز دارند. پیام‌های تراکنش می‌توانند هر تعداد عنصر فرزند داشته باشند، به‌شرطی که اندازه کل پیام از ۱۰۰ مگابایت بیشتر نشود.

برای نمونه‌هایی از «پیام‌های تراکنش» در پاسخ به درخواست‌های Google، مرجع XML قیمت‌گذاری و موجودی اتاق (تراکنش‌ها) را ببینید.

حالت‌های ارسال

نوع و فراوانی ارسال پیام‌های «تراکنش» به حالت ارسال شما بستگی دارد:

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

برای اطلاعات بیشتر، حالت‌های ارسال قیمت‌گذاری را ببینید.

پُرسمان‌های قیمت‌گذاری زنده

صرف‌نظر از حالت ارسال، Google ممکن است درخواست‌هایی را نیز برای شما ارسال کند که به‌عنوان پرس‌وجوهای قیمت‌گذاری زنده شناخته می‌شوند. این پیام‌های «پرسمان» قیمت‌ها را در پاسخ به جستجوی کنونی جستجو می‌کنند. اگر در چارچوب زمانی مشخص‌شده که معمولاً چند صد میلی‌ثانیه است پاسخ دهید، آگهی‌تان می‌تواند در مزایده ظاهر شود. نتایج شما همچنین می‌تواند با مشتری، ازجمله کشور و نوع دستگاه او، و تعداد مهمانانی که مشخص کرده است، مطابقت بهتری داشته باشد. برای اطلاعات بیشتر، پرس‌وجوهای قیمت‌گذاری زنده را ببینید.

اندازه پیام

می‌توانید هر ترکیبی از به‌روزرسانی‌های داده را در یک پیام «تراکنش» قرار دهید، اما اندازه هر پیام به ۱۰۰ مگابایت محدود است. معمولاً همه درخواست‌های «کشیدن» و «راهنمایی» محدودیت زمان پاسخ ۱۰۰ ثانیه‌ای دارند. زمان‌اتمام فیلدی قابل‌پیکربندی است که Google می‌تواند آن را طبق درخواست تنظیم کند. Google توصیه می‌کند که برای پیام‌های بسیار بزرگ، زمان وقفه را روی ۱۰ دقیقه تنظیم کنید.

برای کاهش قابل‌توجه اندازه پیام و احتمالاً جلوگیری از مشکلات مربوط به اندازه پیام و وقفه زمانی، از پیام‌های تراکنش برای تعریف پیشاپیش فراداده اتاق و بسته استفاده کنید. همچنین می‌توانید با افزودن Content-Encoding: gzip به سرصفحه‌های پیام، محتوای فشرده‌شده GNU را به پیام‌ها اضافه کنید.