این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

پرس و جو & نکات مرجع XML

این بخش مرجعی برای پیام‌های درخواست راهنمایی مبتنی بر XML، پیام‌های پاسخ راهنمایی و پیام‌های درخواست ارائه می‌کند.

`<Hint>` (پیام پاسخ راهنمایی)

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

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

پیام‌های پاسخ راهنمایی از یکی از روش‌های زیر برای تعیین هتل‌ها و برنامه‌های سفر Google استفاده می‌کنند:

برنامه های سفر دقیق : ترکیبی از تاریخ ورود و مدت اقامت.
محدوده‌های تاریخ ورود : محدوده‌ای از تاریخ‌های ورود را مشخص می‌کند که از اولین تاریخ ورود شروع می‌شود و به آخرین تاریخ ورود ختم می‌شود.
اقامت در محدوده (یا برنامه های سفر در محدوده )

هر یک از این روش ها برای پیام Hint Response به نحو متفاوتی نیاز دارند.

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

نحو

عنصر <Hint> بسته به نوع پیام Hint Response از نحو متفاوتی استفاده می کند:

برنامه های سفر دقیق

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

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>hotel_ID</Property>
    ...
    <Stay>
      <CheckInDate>checkin_date</CheckInDate>
      <LengthOfStay>number_of_nights</LengthOfStay>
    </Stay>
  </Item>
  ...
</Hint>

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

شکل زیر سینتکس محدوده‌های ورود را در یک پیام پاسخ راهنمایی نشان می‌دهد:

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <!-- Can be > 1 if MultipleItineraries is "checkin_range" in your
         QueryControl message -->
    <Property>hotel_ID</Property>
    [...]

    <!-- Required -->
    <FirstDate>first_checkin_date</FirstDate>
    <!-- Required -->
    <LastDate>last_checkin_date</LastDate>
  </Item>
  ...
</Hint>

محدوده می ماند

شکل زیر نحوی را برای اقامت های محدوده ای در پیام Hint Response نشان می دهد:

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <!-- Can be > 1 if MultipleItineraries is "affected_dates" in your
         QueryControl message -->
    <Property>hotel_ID</Property>
    [...]

    <StaysIncludingRange>
      <!-- Required -->
      <FirstDate>first_date</FirstDate>

      <!-- Optional -->
      <LastDate>last_date</LastDate>
    </StaysIncludingRange>
  </Item>
  ...
</Hint>

ویژگی های

عنصر <Hint> حاوی یک ویژگی اختیاری است: id . هنگامی که ارائه می شود، به عنوان ویژگی hintId در پیام های <Query> ارسال شده بر اساس این <Hint> گنجانده می شود.

عناصر کودک

عنصر <Hint> دارای عناصر فرزند زیر است:

عنصر کودک	ضروری؟	تایپ کنید	نوع پاسخ راهنمایی	شرح
<CheckInDate>	Required	Date	برنامه های سفر دقیق	تاریخ ورود به برنامه سفر.
<FirstDate>	Required	Date	محدوده اعلام حضور و برنامه های سفر در محدوده	اولین تاریخ محدوده تاریخ برای یک محدوده اعلام حضور یا اقامت در محدوده پیام راهنمایی پاسخ. تاریخ ها شامل می شود.
<Item>	Required	Object	همه	ظرفی برای هتل/برنامه سفر که باید به روز شود.
<LastDate>	Required*	Date	محدوده اعلام حضور و برنامه های سفر در محدوده	آخرین تاریخ محدوده تاریخ برای یک محدوده اعلام حضور یا اقامت در محدوده پیام راهنمایی پاسخ. تاریخ ها شامل می شود. * این عنصر برای اقامت در محدوده اختیاری است.
<LengthOfStay>	Required	integer	برنامه های سفر دقیق	تعداد شب های برنامه سفر، به عنوان یک عدد صحیح مثبت بیان می شود.
<Property>	Required	string	همه	شناسه یک هتل، با استفاده از همان شناسه فهرست هتل . تعداد عناصر `<Property>` که می توانید در یک بلوک `<Item>` مشخص کنید با نوع پیام Hint Response تعیین می شود: برنامه های سفر دقیق: تا 100 هتل. محدوده‌های اعلام حضور: اگر `<MultipleItineraries>` را در پیام `<QueryControl>` روی `"checkin_range"` تنظیم کنید، بیش از یک مورد است. اقامت در محدوده: اگر `<MultipleItineraries>` را در پیام `<QueryControl>` روی `"affected_dates"` تنظیم کنید، بیش از یک مورد است.
<Stay>	Required	Object	برنامه های سفر دقیق	محفظه‌ای برای عناصر `<CheckinDate>` و `<LengthOfStay>` در یک پیام راهنمایی دقیق برنامه سفر. هر `<Item>` می تواند فقط یک `<Stay>` داشته باشد.
<StaysIncludingRange>	Required	Object	برنامه های سفر محدوده	محفظه‌ای برای عناصر `<FirstDate>` و `<LastDate>` در پیام Response Hint Stay در محدوده.

مثال ها

برنامه های سفر دقیق

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

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>4</LengthOfStay>
    </Stay>
  </Item>
</Hint>

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

مثال زیر دو هتل را مشخص می کند که قیمت آنها تغییر کرده است و باید دوباره واکشی شوند. Google همه برنامه‌های سفر بین 3 تا 6 ژوئیه را برای دارایی‌های 12345 و 67890 دریافت می‌کند:

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Property>67890</Property>
    <FirstDate>2018-07-03</FirstDate>
    <LastDate>2018-07-06</LastDate>
  </Item>
</Hint>

توجه داشته باشید که برای اینکه یک پیام محدوده check-in بتواند چندین ویژگی را در یک <Item> مشخص کند، مقدار <MultipleItineraries> در <QueryControl> باید روی "checkin_range" تنظیم شود.

محدوده می ماند

مثال زیر دو کاربرد متفاوت از اقامت های محدوده ای را نشان می دهد، یکی برای چند شب و دیگری برای یک شب:

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <!-- Google fetches prices for all itineraries (first and last date are set) -->
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
      <LastDate>2018-07-06</LastDate>
    </StaysIncludingRange>
  </Item>

  <!-- Google fetches prices for a single night (first date only) -->
  <Item>
    <Property>67890</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
    </StaysIncludingRange>
  </Item>
</Hint>

توجه داشته باشید که برای اینکه یک پیام اقامت در محدوده بتواند چندین ویژگی را در یک <Item> مشخص کند، مقدار <MultipleItineraries> در <QueryControl> باید روی "affected_dates" تنظیم شود.

برای هر یک از این مثال‌ها، Google با یک <Query> پاسخ می‌دهد، و سپس باید با یک <Transaction> که شامل به‌روزرسانی‌های قیمت برای هتل‌ها/برنامه‌های سفر مشخص شده است، پاسخ دهید.

`<HintRequest>`

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

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

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

نحو

عنصر <HintRequest> از نحو زیر استفاده می کند:

نحو

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest>
  <LastFetchTime>last_fetch_time</LastFetchTime>
</HintRequest>

ویژگی های

عنصر <HintRequest> هیچ ویژگی ندارد.

عناصر کودک

عنصر <HintRequest> دارای عناصر فرزند زیر است:

عنصر کودک	تایپ کنید	شرح
<LastFetchTime>	DateTime	آخرین باری که گوگل موفق به دریافت پیام پاسخ راهنمایی به پیام درخواست راهنمایی شد. اگر این زمان از آخرین باری که قیمت‌ها را روی سرور خود به‌روزرسانی کردید، قدیمی‌تر است، باید با یک پیام پاسخ راهنمایی که مشخص می‌کند کدام هتل‌ها تغییر کرده‌اند، پاسخ دهید. اگر اخیراً واکشی موفقیت‌آمیز صورت نگرفته باشد، این مقدار روی یک مقدار فاصله ثابت تنظیم می‌شود (برای جلوگیری از مشکلات جدی‌تر در مورد عقب ماندگی‌های بزرگ). مقدار فاصله ثابت فعلی 1000 ثانیه است، اما ممکن است تغییر کند. برای اطلاعات بیشتر، به پیام‌های پاسخ راهنمایی مراجعه کنید.

عنصر کودک

تایپ کنید

شرح

DateTime

آخرین باری که گوگل موفق به دریافت پیام پاسخ راهنمایی به پیام درخواست راهنمایی شد.

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

اگر اخیراً واکشی موفقیت‌آمیز صورت نگرفته باشد، این مقدار روی یک مقدار فاصله ثابت تنظیم می‌شود (برای جلوگیری از مشکلات جدی‌تر در مورد عقب ماندگی‌های بزرگ). مقدار فاصله ثابت فعلی 1000 ثانیه است، اما ممکن است تغییر کند.

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

مثال ها

مثال زیر یک پیام درخواست راهنمایی را نشان می دهد:

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

مثال زیر یک پیام درخواست راهنمایی را نشان می دهد:

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest id="ABCDEF" timestamp="2018-06-07T16:20:00Z">
  <LastFetchTime>2018-03-25T00:04:09Z</LastFetchTime>
</HintRequest>

`<Query>`

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

سه نوع پیام Query وجود دارد:

قیمت گذاری زنده: Google به درخواست کاربر خاصی پاسخ می دهد و درخواست به روز رسانی قیمت در زمان واقعی را می کند. هنگامی که شرکا یک پیام Live pricing query دریافت می کنند، شرکا باید با یک پیام <Transaction> که حاوی اطلاعات قیمت درخواستی در عناصر <Result> است، پاسخ دهند.
نکته کلیدی: به دلیل تجربه جستجوی جدید ، Live Query دیگر برای کاربران منطقه اقتصادی اروپا در دسترس نیست.
با قیمت گذاری زمینه: Google حافظه پنهان قیمت خود را بر اساس زمینه هایی که از لحاظ تاریخی محبوب هستند به روز می کند. هنگامی که یک پیام With context query دریافت می کنید، باید با یک پیام <Transaction> که حاوی اطلاعات قیمت درخواستی در عناصر <Result> است، پاسخ دهید.
فراداده: Google به‌روزرسانی‌های فراداده را برای اتاق‌ها و بسته‌های اتاق را برای هتل‌های مشخص شده درخواست می‌کند. هنگامی که یک پیام Metadata Query دریافت می‌کنید، باید با یک پیام <Transaction> پاسخ دهید که داده‌های مربوط به اتاق‌ها و بسته‌های اتاق را در عناصر <PropertyDataSet> مشخص می‌کند.

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

نحو برای سه نوع مختلف در زیر توضیح داده شده است.

نحو

عنصر <Query> از نحو زیر استفاده می کند:

قیمت گذاری زنده

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyList>
    <Property>hotel_id</Property>
    ...
  </PropertyList>
  <!-- See documentation below for <Context> -->
  <Context>
   ...
  </Context>
</Query>

با زمینه

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyContextList>
    <PropertyContext>
      <Property>hotel_id</Property>
      ...
      <!-- See documentation below for <Context> -->
      <Context>
      ...
      </Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

فراداده

<HotelInfoProperties>
  <Property>property_ID</Property>
  ...
</HotelInfoProperties>

ویژگی های

عنصر <Query> ممکن است حاوی یک ویژگی باشد: latencySensitive .

ویژگی latencySensitive اختیاری است. وقتی ارائه شد و روی true تنظیم شد، نشان می‌دهد که عبارت Live Pricing Query است. برای اینکه Google درخواست هایی را با ویژگی latencySensitive ارسال کند، لطفاً از مدیر حساب فنی خود (TAM) بپرسید.

عناصر کودک

عنصر <Query> دارای عناصر فرزند زیر است:

عنصر کودک	نوع پرس و جو	تایپ کنید	شرح
<AffectedNights>	Pricing	integer	تعداد شب های اقامت در محدوده. این عنصر فقط برای جستارهای قیمت گذاری Ranged Stay استفاده می شود که با Changed Pricing استفاده می شود.
<Checkin>	Pricing	Date	تاریخ تغییر قیمت خاص
<Context>	Pricing (Live Pricing Queries only)	<Context>	برای پرس و جوهای قیمت گذاری زنده، پارامترهای خاصی را مشخص می کند که پرس و جو تحت آنها انجام می شود. عناصر کودک عبارتند از: `<Occupancy>` : تعداد کل مهمانان `<OccupancyDetails>` : نوع مهمانان، مانند بزرگسالان یا کودکان `<UserCountry>` : کشوری که کاربر در آن قرار دارد `<UserDevice>` : نوع دستگاهی که مهمان برای جستجوی هتل استفاده می‌کند، مانند `"mobile` "، " `tablet` " یا " `desktop` ". عنصر `<Context>` ممکن است در یک درخواست تکرار شود و امکان درخواست برای اشغال های مختلف را فراهم کند. برای فهرستی از عناصر فرزند، نحو، و مثال ها به `<Context>` مراجعه کنید.
<FirstDate>	Pricing	Date	تاریخ شروع برای طیف وسیعی از سفرهایی که قیمت برای آنها اعمال می شود. این عنصر فقط برای جستارهای قیمت‌گذاری محدوده تاریخ اعلام حضور که با قیمت‌گذاری تغییر یافته استفاده می‌شود استفاده می‌شود.
<HotelInfoProperties>	Metadata	string	یک یا چند ویژگی که Google برای آنها متاداده اتاق و Room Bundle به‌روزرسانی شده را در پیام `Query` فراداده می‌خواهد. این عنصر می‌تواند حاوی یک یا چند عنصر `<Property>` باشد که شناسه‌های دارایی هتل را مشخص می‌کنند.
<LastDate>	Pricing	Date	تاریخ پایان برای طیف وسیعی از سفرهایی که قیمت برای آنها اعمال می شود. این عنصر فقط برای جستارهای قیمت‌گذاری محدوده تاریخ اعلام حضور با استفاده از Pull + Hints استفاده می‌شود.
<Nights>	Pricing	integer	تعداد شب ها برای یک برنامه سفر خاص، تا 30 شب.
<PropertyList>	Pricing	Object	یک یا چند شناسه هتل که نیاز به به‌روزرسانی قیمت دارد. هر هتل را در عنصر `<Property>` تعریف کنید. مقدار رشته ای است که با شناسه هتل در لیست هتل شما مطابقت دارد. مثلا: <PropertyList> <Property>pid1</Property> <Property>pid2</Property> </PropertyList>

مثال ها

استعلام قیمت

مثال زیر یک پیام درخواست قیمت را نشان می‌دهد که درخواست به‌روزرسانی قیمت برای مجموعه‌ای از هتل‌ها را می‌دهد که برای 3 شب در دسترس است و از 10 ژوئن 2018 شروع می‌شود:

<?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>

استعلام قیمت زنده

مثال زیر یک پرس و جو قیمت زنده را با محدودیت زمانی پاسخ 500 میلی ثانیه نشان می دهد:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="8"/>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

با پرس و جو زمینه

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, occupancy and 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>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

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

`<Context>`

عنصر <Context> اطلاعاتی را برای Live pricing query ، از جمله تعداد و نوع مهمانان، کشور کاربر و دستگاه کاربر توضیح می دهد.

چند <Context> هرگز با کشورهای مختلف کاربر یا دستگاه های کاربر استفاده نخواهد شد. هنگامی که از چند <Context> برای پرس و جو برای چند اشغال استفاده می شود، لطفاً قیمت هر اشغال را به عنوان بسته اتاق اضافی برای ملک/برنامه سفر مربوطه ارائه دهید. هر ملک/برنامه سفر باید دارای یک بلوک <Result> باشد که شامل قیمت‌های چند اشغال باشد.

برای جزئیات پاسخ به پرسش <Context> ، <OccupancyDetails> را ببینید.

نحو

عنصر <Context> از نحو زیر استفاده می کند:

نحو

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>date</Checkin>
  <Nights>number_of_nights</Nights>
  <DeadlineMs>number_of_milliseconds</DeadlineMs>
  <PropertyList>
    <Property>property_ID</Property>
  </PropertyList>
  <Context>
  <Occupancy>total_number_of_guests</Occupancy>
  <OccupancyDetails>
    <NumAdults>number_of_adults</NumAdults>
    <Children>
      <Child age=age_of_one_child_guest/>
      <Child age=age_of_one_child_guest/>
    </Children>
  </OccupancyDetails>
  <UserCountry>end_user_country</UserCountry>
  <UserDevice>user_device_type</UserDevice>
  </Context>
</Query>

عناصر کودک

عنصر <Context> دارای عناصر فرزند زیر است:

عنصر کودک	نوع پرس و جو	تایپ کنید	شرح
<Occupancy>	Pricing	integer	تعداد کل مهمانان را مشخص می کند. اگرچه اجباری نیست، جستارهای با `<Occupancy>` باید منجر به یک پیام تراکنش با بسته های اتاق مناسب برای هر `<Occupancy>` درخواست شده شود. توجه: `<Occupancy>` ممکن است همیشه در یک جستجو ظاهر نشود. در چنین مواردی، شما باید قیمت تمام اشغال ها را برگردانید.
<OccupancyDetails>	Pricing	Object	قبل از `<Occupancy>` آمده است. مهمانان را بر اساس نوع مشخص می کند، از جمله: `<NumAdults>` : تعداد مهمانان بزرگسال `<Children>` و `<Child=" age ">` : مشخص می کند که کدام مهمانان کودک هستند (معمولاً 0-17 سال)، و به صورت اختیاری شامل سن هر کودک می شود. اگرچه اجباری نیست، درخواست‌های `<OccupancyDetails>` باید منجر به یک پیام تراکنش با بسته‌های اتاق مناسب برای هر `<Occupancy>` درخواست شده شود. توجه: `<OccupancyDetails>` ممکن است همیشه در یک جستجو ظاهر نشود. در چنین مواقعی باید فرض کنید که همه مهمانان بزرگسال هستند.
<UserCountry>	Pricing	string	نرخ ها را بر اساس کشوری که کاربر در آن قرار دارد فیلتر می کند. مقدار یک کد کشور 2 حرفی مانند `“US”` برای ایالات متحده، یا یک کد منطقه، مانند `"EU"` برای "Europe" است. پرس و جوهایی با `<UserCountry>` تعریف شده باید منجر به یک پیام تراکنش با بلوک `<Rates>` مناسب برای کشور مورد درخواست شود.
<UserDevice>	Pricing	string	نرخ ها را بر اساس نوع دستگاهی که کاربر از آن جستجو می کند فیلتر می کند. مقادیر ممکن: `mobile` `desktop` `tablet` پرس و جوهایی با `<UserDevice>` تعریف شده باید منجر به یک پیام تراکنش با بلوک `<Rates>` مناسب برای نوع دستگاه درخواست شده شود.

مثال ها

تصرف

مثال زیر یک جستار قیمت گذاری زنده برای <Occupancy> را در <Context> نشان می دهد. درخواست قیمت زنده برای 3 مهمان بزرگسال است.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

جزئیات اشغال

مثال زیر یک جستار قیمت گذاری زنده را با <OccupancyDetails> در <Context> نشان می دهد. درخواست قیمت زنده برای 4 مهمان است که 2 نفر از آنها کودک هستند و به دنبال نرخی است که برای رزرو مهمان در ایالات متحده از دستگاه تلفن همراه اعمال می شود:

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="4"/>
        <Child age="12"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

زمینه های متعدد

مثال زیر استفاده از عنصر <Context> اضافی را در جستار قیمت گذاری زنده نشان می دهد.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
  <Context>
    <Occupancy>6</Occupancy>
    <OccupancyDetails>
      <NumAdults>4</NumAdults>
      <Children>
        <Child age="6"/>
        <Child age="10"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

پرس و جو & نکات مرجع XML

<Hint> (پیام پاسخ راهنمایی)

نحو

برنامه های سفر دقیق

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

محدوده می ماند

ویژگی های

عناصر کودک

مثال ها

برنامه های سفر دقیق

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

محدوده می ماند

<HintRequest>

نحو

نحو

ویژگی های

عناصر کودک

مثال ها

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

<Query>

نحو

قیمت گذاری زنده

با زمینه

فراداده

ویژگی های

عناصر کودک

مثال ها

استعلام قیمت

استعلام قیمت زنده

با پرس و جو زمینه

پرس و جو فراداده

<Context>

نحو

نحو

عناصر کودک

مثال ها

تصرف

جزئیات اشغال

زمینه های متعدد

`<Hint>` (پیام پاسخ راهنمایی)

`<HintRequest>`

`<Query>`

`<Context>`