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

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

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

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

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

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

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

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

پاسخ شریک

پیام Hint Response زیر یک ویژگی و یک برنامه سفر را تعریف می کند:

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

پاسخ گوگل

Google به پیام Hint Response شما با یک <Query> مشابه موارد زیر پاسخ می دهد:

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

<Transaction> را ایجاد کنید

سپس از شما انتظار می رود برای اقامت زیر یک <Transaction> با به روز رسانی قیمت برای هتل ایجاد کنید:

5/20/23 - 5/23/23

درخواست محدوده تاریخ ورود و جریان پاسخ

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

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

مثال زیر برای پیام Hint Response یک ویژگی منفرد با طیف وسیعی از تاریخ‌ها را برای ورود تعریف می‌کند:

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

پاسخ گوگل

Google به این پیام Hint Response با <Query> مشابه موارد زیر پاسخ می دهد:

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

<Transaction> را ایجاد کنید

سپس از شما انتظار می رود که یک <Transaction> با به روز رسانی قیمت برای اقامت های زیر برای آن هتل ایجاد کنید:

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

این مثال از مدت اقامت پیش فرض 5 شب استفاده می کند.

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

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

اقامت های محدوده شریک

مثال زیر پیام Hint Response از اقامت های محدوده استفاده می کند:

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

پاسخ گوگل

Google به پیام Hint Response شما با یک <Query> مشابه موارد زیر پاسخ می دهد:

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

<Transaction> را ایجاد کنید

سپس از شما انتظار می رود برای اقامت های زیر یک <Transaction> با به روز رسانی قیمت برای هتل ایجاد کنید:

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