پیام‌های پرسمان

پیام‌های پرسمان درخواست‌هایی از Google برای به‌روزرسانی قیمت‌گذاری یا فراداده است. این‌ها با هر دو حالت ارسال «کشیدن» و «قیمت تغییریافته» استفاده می‌شوند.

عنصر ریشه پیام‌های «پرسمان» <Query> است.

ساختار پیام «پرسمان» به نوع پیام بستگی دارد:

  • قیمت‌گذاری: Google پیام پرسمانی ارسال می‌کند که به‌روزرسانی‌های قیمت‌گذاری را برای هتل‌های مشخص‌شده درخواست می‌کند.

  • فراداده: Google پیام پرسمانی ارسال می‌کند که داده‌های مربوط به اتاق و اطلاعات بسته را در هتل‌های مشخص‌شده درخواست می‌کند.

شما نقطه پایانی را که Google برای پیام‌های «پرسمان» و «پرسمان‌های قیمت‌گذاری زنده» استفاده می‌کند درطول پیکربندی اولیه تعریف می‌کنید. برای اطلاعات بیشتر، با «مدیر فنی حساب» (TAM) تماس بگیرید.

Google پیام «پرسمان» را به‌عنوان درخواست اچ‌تی‌تی‌پی POST ارسال می‌کند که سرایند Content-Type آن روی «application/xml» و سرایند User-Agent آن روی Google-HotelAdsPrices تنظیم شده است. استثنای این قانون درطول آزمایش دستی ادغام نقطه پایانی قیمت ازطریق Google-TravelAds-Live رخ می‌دهد. این پُرسمان‌های نمونه ممکن است حاوی سرصفحه User-Agent باشند یا نباشند.

قالب‌بندی دقیق برای پیام‌های «پرسمان» را می‌توانید در مرجع XML پرسمان پیدا کنید.

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

پیام‌های «پرسمان قیمت‌گذاری» ترکیب‌های هتل و برنامه سفری را مشخص می‌کنند که قیمت‌های آن‌ها را ارائه می‌دهید.

وقتی سرورتان پیام پرسمان قیمت‌گذاری دریافت می‌کند، باید با پیام <Transaction> که حاوی اطلاعات قیمت‌گذاری درخواستی است پاسخ دهد.

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

سه نوع خاص از پیام‌های «پرسمان» وجود دارد:

  1. قیمت‌گذاری زنده: اگر فعال باشد، وقتی کاربر به‌طور فعال درحال مرور قیمت‌ها برای ترکیب ملک یا برنامه سفر مشخص‌شده باشد، پُرسمان‌ها ارسال می‌شوند و شما چارچوب زمانی مشخصی برای پاسخ دادن دارید.

  2. با بافت: اگر فعال باشد، توصیه‌های بافت کاربر در هر پُرسمانی که Google برایتان ارسال می‌کند گنجانده می‌شود و توصیه‌ها منعکس‌کننده رایج‌ترین انواع کاربرانی است که برای ترکیب‌های هتل یا برنامه سفر ارائه‌شده جستجو می‌کنند. دنبال کردن این توصیه‌ها ممکن است کارایی پاسخ‌هایتان را افزایش دهد.

  3. فراداده: این درخواستی برای جزئیات مربوط به اتاق‌ها و بسته‌ها برای املاک مشخص‌شده است.

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

پرسمان‌های قیمت‌گذاری زنده درخواست‌هایی از Google برای به‌روزرسانی‌های قیمت هم‌زمان در پاسخ به جستجوهای کاربر هستند. Google درخواست جستجویی از کاربر برای ترکیب هتل یا برنامه سفر دریافت می‌کند و چون داده‌های قیمت‌گذاری دردسترس نیست یا به‌روز نیست، Google در زمان جستجو درخواست به‌روزرسانی قیمت را از شما می‌کند. با پرس‌وجوی قیمت‌گذاری زنده، Google تلاش می‌کند قیمت را دریافت کند و آن را در نتایج در زمان جستجو نمایش دهد.

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

پرس‌وجوهای قیمت‌گذاری زنده نیز بافتاری هستند و می‌توانند قیمت‌ها را برای پارامترهای زیر بازیابی کنند: کشور کاربر، نوع دستگاه، تعداد مهمانان، و اینکه آیا این مهمانان بزرگسال هستند یا کودک. با پُرسمان‌های قیمت‌گذاری زنده، می‌توانید قیمت‌های به‌روزتری را نشان دهید که با آنچه مشتری جستجو کرده است مطابقت دارد.

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

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

  • هیچ داده ذخیره‌شده‌ای برای برنامه سفر ارائه‌شده وجود ندارد زیرا برنامه سفر درخواستی غیرمعمول است، مثلاً تاریخ‌ها مربوط به آینده بسیار دور است یا هتل به‌ندرت جستجو می‌شود.

  • تاریخ درخواست‌شده تاریخ غیرپیش‌فرض است.

: توجه: تاریخ‌های پیش‌فرض برای پُرسمان‌های قیمت‌گذاری زنده واجدشرایط نیستند. پرس‌وجوهای قیمت‌گذاری زنده فقط برای تاریخ‌های غیرپیش‌فرض درخواست می‌شود.

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

ویژگی قیمت‌گذاری زنده با بافت به Google امکان می‌دهد درخواست‌های قیمت‌گذاری زنده خاصی را براساس نوع دستگاه کاربر، کشوری که از آن جستجو می‌کند، و تعداد ساکنان ازجمله کودکان ارسال کند. هم «پیام پرسمان» و هم «پیام تراکنش» گسترش یافته‌اند تا عنصر <Context> را که پارامترهای پرسمان را تعریف می‌کند دربرگیرند. قیمت‌های دریافتی از پُرسمان‌های قیمت‌گذاری زنده با بافت را می‌توان به‌عنوان بسته ترکیبی اتاق ذخیره کرد، اگر قیمت برای اشغال خاصی باشد و به‌عنوان نرخ شرطی، اگر برای کشور کاربر یا دستگاه کاربر باشد.

با پُرسمان‌های «بافت»

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

اگر به دریافت پُرسمان‌های «با بافت» علاقه دارید، با «مدیر فنی حساب» (TAM) خود تماس بگیرید. آن‌ها می‌توانند تأیید کنند که شما آماده دریافت چنین پیام‌هایی هستید و سپس پیکربندی را اصلاح کنند تا ارسال زمینه‌های کاربر در پُرسمان‌ها به شما آغاز شود.

پیام‌های پرسمان فراداده

پیام‌های پرسمان فراداده حاوی جزئیاتی درباره اطلاعات اتاق و بسته برای دارایی‌های مشخص‌شده است.

وقتی پیام پرسمان فراداده دریافت می‌کنید، باید با پیام <Transaction> که قیمت‌گذاری برای دارایی‌های درخواستی را در عناصر <Result> مشخص می‌کند پاسخ دهید.

برای اطلاعات بیشتر، به تعریف فراداده اتاق و بسته مراجعه کنید.

نمونه‌های پیام پرسمان

این بخش چند نمونه از پیام‌های «پرسمان» قیمت‌گذاری و یک پیام «پرسمان» فراداده را نشان می‌دهد. نمونه‌های بیشتر در مرجع XML پُرسمان موجود است.

نمونه برنامه سفر

مثال زیر <Query> قیمت‌گذاری را نشان می‌دهد که به‌روزرسانی قیمت را برای ۴ هتل، دردسترس برای ۳ شب، و شروع از ۲۳ مه ۲۰۲۳ درخواست می‌کند:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

این نمونه به‌روزرسانی‌های قیمت‌گذاری را برای هر هتل درخواست می‌کند:

5/23/18 - 6/26/18

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

نمونه زیر پُرسمان قیمت‌گذاری زنده را با محدودیت زمانی پاسخ ۵۰۰ میلی‌ثانیه نشان می‌دهد:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

این نمونه قیمت یک هتل را درخواست می‌کند:

6/23/23 - 6/25/23

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

با نمونه‌های پُرسمان «بافت»

موارد زیر نمونه‌هایی از پُرسمان «با بافت» هستند:

پرسمان پایه با بافت

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

پرسمان با بافت شامل اشغال

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2025-07-10</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <Context>
        <UserCountry>US</UserCountry>
      </Context>
      <Occupancy>3</Occupancy>
      <OccupancyDetails>
        <NumAdults>2</NumAdults>
        <Children>
          <Child age="7"/>
        </Children>
      </OccupancyDetails>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Context>
        <UserCountry>GB</UserCountry>
      </Context>
      <Occupancy>1</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
      </OccupancyDetails>
    </PropertyContext>
  </PropertyContextList>
</Query>

بااستفاده از «با بافت»، پُرسمان‌ها فقط بافت کشور کاربر را مشخص می‌کند. در آینده، چنین پُرسمان‌هایی ممکن است دستگاه کاربر را نیز مشخص کنند.

محدوده تاریخ ورود

اگر از «قیمت‌گذاری تغییریافته» استفاده می‌کنید، ساختار «پیام پرسمان» به نوع راهنمایی که برای محدوده‌های تاریخ ورود، برنامه سفر دقیق، یا برنامه سفر محدوده‌ای استفاده می‌کنید بستگی دارد. برای اطلاعات بیشتر درباره هرکدام از این انواع خوانایاری، پیام‌های پاسخ خوانایاری را ببینید.

مثال زیر پیام قیمت‌گذاری <Query> را برای محدوده‌های تاریخ ورود نشان می‌دهد:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

این نمونه به‌روزرسانی قیمت را برای اقامت‌های زیر (برای هر هتل) درخواست می‌کند:

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

اقامت‌های محدوده‌ای

مثال زیر پیام قیمت‌گذاری <Query> را برای اقامت‌های محدوده‌ای نشان می‌دهد:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <FirstDate>2023-05-23</FirstDate>
  <LastDate>2023-05-26</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

این نمونه به‌روزرسانی‌های قیمت‌گذاری را برای هر هتل درخواست می‌کند:

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

به‌علاوه اقامت‌هایی که قبل‌از شب موردنظر شروع شده‌اند (اما شامل آن شب می‌شوند):

5/20/23 - 5/23/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23

پیام پرسمان فراداده

مثال زیر پیام <Query> را نشان می‌دهد که به‌روزرسانی فراداده را برای اتاق و اطلاعات بسته برای چند ملک درخواست می‌کند:

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

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