با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
پیام‌های تراکنش داده‌های مربوط به اتاق‌ها، قیمت‌ها و بسته‌ها را به Google ارسال می‌کنند. دو نوع اصلی از پیام های تراکنش وجود دارد:
داده‌های برنامه سفر : بسته اتاق و داده‌های برنامه سفر را تعریف کنید، از جمله:
قیمت و موجودی هتل : حداقل قیمت را برای برنامه سفری که الزامات خاصی را برآورده می کند، تعیین کنید. برای اطلاعات بیشتر، به روز رسانی قیمت ها را ببینید. شما همچنین می توانید یک اتاق را از موجودی حذف کنید. برای اطلاعات بیشتر، به حذف موجودی مراجعه کنید.
بسته‌های اتاق : قیمت‌های برنامه سفر را برای ترکیبی از یک اتاق فیزیکی و بسته‌ای از خدمات اضافی تنظیم کنید. برای اطلاعات بیشتر، Room Bundles . Google محتوای پیام‌های تراکنش شما را در حافظه پنهان ذخیره می‌کند تا قیمت‌ها همیشه در دسترس باشد. در برخی موارد، Google تشخیص می‌دهد که مقادیر موجود در حافظه پنهان آن به‌روز نیستند، بنابراین ممکن است پیام‌های <Query> اضافی (یا در برخی موارد، Queries Live Pricing Queries ) برای دریافت قیمت‌های به‌روز ارسال کند. این داده ها معمولاً اغلب تغییر می کنند. برای تعریف قیمت و در دسترس بودن پیام های تراکنش، از <Result> استفاده کنید.
فراداده اتاق و بسته : جزئیات مربوط به اتاق‌ها و بسته‌ها، مانند توضیحات، عکس‌ها و حداکثر اشغال را مشخص می‌کند. این داده ها اغلب تغییر نمی کنند. برای تعریف پیام‌های تراکنش فراداده، از <PropertyDataSet> استفاده کنید. Google این ابرداده را ذخیره می‌کند تا بتوانید از پیام‌های قیمت‌گذاری خود به آن رجوع کنید، نه اینکه اطلاعات تکراری درباره اتاق‌ها و بسته‌ها را در هر اتاق قرار دهید. برای اطلاعات بیشتر، به تعریف فراداده اتاق و بسته مراجعه کنید.
عنصر اصلی یک پیام تراکنش <Transaction> است. پیام هایی که از عنصر <Transaction> به عنوان عنصر اصلی استفاده می کنند حداقل به یکی از عناصر فرزند نیاز دارند. پیام‌های تراکنش می‌توانند هر تعداد عنصر فرزند داشته باشند، تا زمانی که حجم پیام از 100 مگابایت تجاوز نکند.
صرف نظر از حالت تحویل شما، Google ممکن است درخواست‌هایی را نیز برای شما ارسال کند که به عنوان جستارهای قیمت‌گذاری زنده شناخته می‌شوند. این پیام‌های پرس‌وجو قیمت‌ها را در پاسخ به جستجوی فعلی جستجو می‌کنند. اگر در بازه زمانی مشخص شده که معمولاً چند صد میلی ثانیه است پاسخ دهید، آگهی شما می تواند در حراج ظاهر شود. نتایج شما همچنین می‌تواند با مشتری، از جمله کشور، نوع دستگاه، و تعداد مهمانانی که مشخص کرده‌اند، بهتر مطابقت داشته باشد. برای اطلاعات بیشتر، پرس و جوهای قیمت زنده را ببینید.
اندازه پیام
می‌توانید هر ترکیبی از به‌روزرسانی‌های داده را در یک پیام تراکنش قرار دهید، اما برای اندازه هر پیام یک محدودیت 100 مگابایتی وجود دارد. به طور معمول، تمام درخواست‌های Pull و Hint دارای محدودیت زمانی 100 ثانیه‌ای هستند. مهلت زمانی یک فیلد قابل تنظیم است که توسط Google مطابق درخواست قابل تنظیم است. گوگل توصیه می‌کند که برای پیام‌های بسیار بزرگ، زمان استراحت را روی ۱۰ دقیقه تنظیم کنید.
برای کاهش تا حد زیادی اندازه پیام و اجتناب بالقوه از مشکلات مربوط به اندازه پیام و وقفه‌های زمانی، از پیام‌های تراکنش برای پیش‌تعریف فراداده اتاق و بسته خود استفاده کنید. همچنین می‌توانید با افزودن Content-Encoding: gzip به هدر پیام‌ها، محتوای فشرده‌شده گنو را به پیام‌ها اضافه کنید.
کلیه حقوق محفوظ است. Java علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eTransaction messages relay data about rooms, prices, and packages to Google, encompassing itinerary details (like pricing and inventory) and room/package metadata (descriptions, photos, etc.).\u003c/p\u003e\n"],["\u003cp\u003eThese messages are delivered via Pull or Changed Pricing modes, with Google occasionally requesting live pricing for real-time search results (except for EEA users due to the new search experience).\u003c/p\u003e\n"],["\u003cp\u003eTransaction messages can combine various data updates, but they're limited to 100MB; pre-defining room/package metadata and using gzip compression can help manage size.\u003c/p\u003e\n"],["\u003cp\u003eGoogle might request updated pricing through additional Query or Live Pricing Queries if its cached data is deemed outdated, ensuring accurate information is displayed.\u003c/p\u003e\n"],["\u003cp\u003eWhen defining pricing and availability within Transaction messages, either \u003ccode\u003e<AllowablePackageIDs>\u003c/code\u003e or \u003ccode\u003e<AllowableRoomIDs>\u003c/code\u003e should be used, but not both, to specify room type and rate plan combinations.\u003c/p\u003e\n"]]],[],null,["# Overview of Transaction messages\n\nTransaction messages send data about rooms, prices, and packages to Google.\nThere are two primary types of Transaction messages:\n\n1. **Itinerary data**: Define Room Bundle and itinerary data including:\n\n - *Hotel prices and inventory* : Set the minimum price for an itinerary that\n meets certain requirements. For more information, see\n [Updating Prices](/hotels/hotel-prices/dev-guide/updating-prices).\n You can also remove a room from inventory. For more information, see\n [Remove inventory](/hotels/hotel-prices/dev-guide/removing-inventory).\n\n - *Room Bundles* : Set the itinerary prices for a combination of a physical\n room and a package of additional services. For more information,\n [Room Bundles](/hotels/hotel-prices/dev-guide/room-bundles).\n Google caches the contents of your Transaction messages so that the prices\n are available at all times. In some cases, Google determines that the values\n in its cache are not up to date, so it might send additional [`\u003cQuery\u003e`](../xml-reference/queries#Query)\n messages (or in some cases, [Live Pricing Queries](/hotels/hotel-prices/dev-guide/query-messages#live_pricing_queries))\n to get updated prices. This data typically changes very frequently. To\n define pricing and availability of Transaction messages, use [`\u003cResult\u003e`](../xml-reference/transaction-messages#Result).\n\n2. **Room and package metadata** : Specifies details about rooms and packages,\n such as a descriptions, photos, and maximum occupancy. This data does not\n change very often. To define metadata Transaction messages, use\n [`\u003cPropertyDataSet\u003e`](../xml-reference/transaction-messages#PropertyDataSet). Google stores this metadata so that you can refer to it\n from your pricing messages rather than include repetitive information about\n rooms and packages in every one. For more information, see\n [Define room and package metadata](/hotels/hotel-prices/dev-guide/room-bundles#metadata).\n\nThe root element of a Transaction message is [`\u003cTransaction\u003e`](../xml-reference/transaction-messages#Transaction). Messages that use\nthe `\u003cTransaction\u003e` element as the root element require at least one of the\nchild elements. Transaction messages can have any number of child elements, as\nlong as the total message size does not exceed 100MB.\n| **Key Point:** Use either `\u003cAllowablePackageIDs\u003e` or `\u003cAllowableRoomIDs\u003e`, but not both. If neither of these elements are defined in the Transaction message, room types can be combined with any rate plan.\n\nFor examples of Transaction messages responding to requests by Google, see\n[Pricing \\& Room Inventory (Transactions) XML Reference](/hotels/hotel-prices/xml-reference/transaction-messages).\n\nDelivery modes\n--------------\n\nThe type and frequency with which you send Transaction messages depends on your\ndelivery mode:\n\n- For the Pull delivery mode, you send Transaction messages when you receive a [`\u003cQuery\u003e`](../xml-reference/queries#Query) from Google.\n- For the Changed Pricing delivery mode, you send a Transaction message after receiving and responding to a [`\u003cHintRequest\u003e`](../xml-reference/queries#hintrequest) and `\u003cQuery\u003e`.\n\nFor more information, see [Pricing Delivery modes](/hotels/hotel-prices/dev-guide/delivery-mode).\n\nLive pricing queries\n--------------------\n\nRegardless of your delivery mode, Google might also send you requests known as\n*Live pricing queries* . These Query messages seek prices in response to a\n*current* search. If you respond within the specified timeframe which is\nusually a few hundred milliseconds, then your ad can appear in the auction.\nYour results can also better match the customer, including their country and\ndevice type, and the number of guests they specified. For more information, see\n[Live pricing queries](/hotels/hotel-prices/dev-guide/query-messages#live_pricing_queries).\n| **Key Point:** Due to the [New Search experience](/search/blog/2024/02/search-experiences-in-eea), Live Query has limited availability for EEA users.\n\nMessage size\n------------\n\nYou can include any combination of data updates in a single Transaction message,\nbut there is a 100MB limit on the size of each message. Typically, all Pull and\nHint Requests have a response time limit of 100 seconds. The timeout is a\nconfigurable field adjustable by Google as requested. Google recommends that you\nset the time-out to 10 minutes for very large messages.\n\nTo greatly reduce message size and potentially avoid issues with message\nsizes and time-outs, use Transaction messages to pre-define your\n[room and package metadata](/hotels/hotel-prices/dev-guide/room-bundles#metadata).\nYou can also add GNU zipped content to messages by adding\n`Content-Encoding: gzip` to the message headers."]]
