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

وقتی گوگل یک پیام درخواست راهنمایی ارسال می‌کند، سرورهای شما باید با یک پیام پاسخ راهنمایی پاسخ دهند که هتل‌هایی را که قیمت آنها از آخرین باری که گوگل یک پاسخ راهنمایی موفق از همان سرورها دریافت کرده است، تغییر کرده است، مشخص می‌کند. اگر تغییری در قیمت وجود داشته باشد، گوگل یک <Query> ارسال می‌کند که داده‌های قیمت‌گذاری به‌روز شده را برای هتل‌ها و برنامه‌های سفر مشخص شده دریافت می‌کند.

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

پیام‌های Hint Response از روش‌های زیر برای تغییر قیمت هتل‌های انتخاب‌شده و برنامه‌های سفر آنها استفاده می‌کنند:

• برنامه‌های دقیق سفر
• محدوده‌های تاریخ ورود
• اقامت‌های محدود

عنصر ریشه یک پیام Hint Response، <Hint> است. شما با استفاده از یک یا چند عنصر <Item> درخواست به‌روزرسانی یک هتل یا برنامه سفر را می‌دهید. یک پیام Hint Response می‌تواند هر تعداد عنصر <Item> را تعریف کند.

هر پیام پاسخ راهنما باید حداقل یک عنصر <Property> را برای هر <Item> مشخص کند. <Property> با استفاده از همان شناسه‌های فهرست هتل ، یک هتل را شناسایی می‌کند. به طور پیش‌فرض، شما برای هر بلوک <Item> یک شناسه هتل مشخص می‌کنید. با این حال، اگر از محدوده‌های تاریخ ورود یا اقامت‌های محدوده‌دار برای تغییر قیمت استفاده می‌کنید، می‌توانید به گوگل دستور دهید که چندین هتل را در یک بلوک کالا مجاز کند.

جریان دقیق درخواست و پاسخ برنامه سفر

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

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

5/20/23 - 5/23/23

جریان درخواست و پاسخ در بازه‌های زمانی ورود

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

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

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

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

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

جریان درخواست و پاسخ در محدوده‌ی مشخصی باقی می‌ماند

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

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

5/17/23 - 5/20/23

5/18/23 - 5/20/23
5/18/23 - 5/21/23

5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23

5/21/23 - 5/22/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

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23