Trang này được dịch bởi Cloud Translation API.

Tài liệu tham khảo XML về truy vấn & Gợi ý

Phần này cung cấp thông tin tham khảo cho thông báo Yêu cầu gợi ý, thông báo Phản hồi gợi ý và thông báo Truy vấn dựa trên XML của Google.

`<Hint>` (thông báo Phản hồi gợi ý)

Thành phần gốc của thông báo Phản hồi gợi ý. Thông báo Phản hồi gợi ý chỉ định những tổ hợp khách sạn/hành trình nào cần được định giá lại. Đó là phản hồi của bạn cho thông báo Yêu cầu gợi ý từ Google.

Thông báo Phản hồi gợi ý chỉ nên xác định những khách sạn có giá đã thay đổi kể từ lần gần nhất Google nhận được Phản hồi gợi ý thành công từ máy chủ của bạn.

Thông báo Phản hồi gợi ý sử dụng một trong các phương thức sau để chỉ định khách sạn và hành trình mà Google cần đặt giá lại:

Hành trình chính xác: Tổ hợp ngày nhận phòng và thời gian lưu trú.
Phạm vi ngày nhận phòng: Chỉ định phạm vi ngày nhận phòng, bắt đầu từ ngày nhận phòng đầu tiên và kết thúc bằng ngày nhận phòng cuối cùng.
Thời gian lưu trú theo phạm vi (hay còn gọi là hành trình theo phạm vi)

Mỗi phương thức yêu cầu một cú pháp riêng cho thông báo Phản hồi gợi ý.

Để biết thêm thông tin, hãy tham khảo bài viết Thông báo Phản hồi gợi ý.

Cú pháp

Cú pháp của phần tử <Hint> sẽ khác nhau, tuỳ thuộc vào loại thông báo Phản hồi gợi ý:

Hành trình chính xác

Dưới đây là ví dụ về cú pháp khi dùng hành trình chính xác trong thông báo Phản hồi gợi ý:

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

Phạm vi ngày nhận phòng

Dưới đây là ví dụ về cú pháp khi dùng phạm vi ngày nhận phòng trong thông báo Phản hồi gợi ý:

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

Thời gian lưu trú theo phạm vi ngày

Dưới đây là cú pháp khi dùng thời gian lưu trú theo phạm vi ngày trong thông báo Phản hồi gợi ý:

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

Thuộc tính

Phần tử <Hint> chứa thuộc tính không bắt buộc: id. Khi được cung cấp, thuộc tính này được đưa vào dưới dạng thuộc tính hintId trong các thông báo <Query> được gửi dựa trên <Hint> này.

Phần tử con

Phần tử <Hint> có các phần tử con như sau:

Thành phần con	Bắt buộc?	Loại	Loại phản hồi gợi ý	Nội dung mô tả
<CheckInDate>	Required	Date	Hành trình chính xác	Ngày nhận phòng trong hành trình.
<FirstDate>	Required	Date	Phạm vi ngày nhận phòng và hành trình theo phạm vi ngày	Ngày đầu tiên trong phạm vi ngày của thông báo Phản hồi gợi ý theo phạm vi ngày nhận phòng hoặc thời gian lưu trú theo phạm vi ngày. Ngày được tính toàn bộ.
<Item>	Required	Object	Tất cả	Vùng chứa khách sạn/hành trình cần cập nhật.
<LastDate>	Required*	Date	Phạm vi ngày nhận phòng và hành trình theo phạm vi ngày	Ngày cuối cùng trong phạm vi ngày của thông báo Phản hồi gợi ý theo phạm vi ngày nhận phòng hoặc thời gian lưu trú theo phạm vi ngày. Ngày được tính toàn bộ. * Phần tử này là không bắt buộc đối với thời gian lưu trú theo phạm vi ngày.
<LengthOfStay>	Required	integer	Hành trình chính xác	Số đêm trong hành trình, được biểu thị bằng một số nguyên dương.
<Property>	Required	string	Tất cả	Mã của khách sạn, sử dụng cùng một mã với Danh sách khách sạn. Số lượng phần tử `<Property>` mà bạn có thể chỉ định trong một khối `<Item>` được xác định theo loại thông báo Phản hồi gợi ý: Hành trình chính xác: Tối đa 100 khách sạn. Phạm vi ngày nhận phòng: Nhiều hơn một nếu bạn đặt `<MultipleItineraries>` thành `"checkin_range"` trong thông báo `<QueryControl>`. Thời gian lưu trú theo phạm vi ngày: Nhiều hơn một nếu bạn đặt `<MultipleItineraries>` thành `"affected_dates"` trong thông báo `<QueryControl>`.
<Stay>	Required	Object	Hành trình chính xác	Vùng chứa các phần tử `<CheckinDate>` và `<LengthOfStay>` trong thông báo Phản hồi gợi ý chính xác của hành trình. Mỗi `<Item>` chỉ có thể chứa một `<Stay>` duy nhất.
<StaysIncludingRange>	Required	Object	Hành trình theo phạm vi	Vùng chứa các phần tử `<FirstDate>` và `<LastDate>` trong thông báo Phản hồi gợi ý theo thời gian lưu trú theo phạm vi ngày.

Ví dụ

Hành trình chính xác

Ví dụ sau đây xác định nhiều hành trình cho một cơ sở lưu trú duy nhất trong một thông báo Phản hồi gợi ý:

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

Phạm vi ngày nhận phòng

Ví dụ sau đây chỉ định hai khách sạn có giá đã thay đổi và cần được tìm nạp lại. Google sẽ lấy tất cả hành trình từ ngày 3 tháng 7 đến ngày 6 tháng 7 đối với các cơ sở lưu trú 12345 và 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>

Xin lưu ý rằng để thông báo phạm vi ngày nhận phòng có thể chỉ định nhiều cơ sở lưu trú trong một <Item>, giá trị của <MultipleItineraries> trong <QueryControl> phải được đặt thành "checkin_range".

Thời gian lưu trú theo phạm vi ngày

Ví dụ sau đây cho thấy hai cách sử dụng thời gian lưu trú theo phạm vi ngày, một cho nhiều đêm và một cho một đêm:

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

Xin lưu ý rằng để thông báo về thời gian lưu trú theo phạm vi ngày có thể chỉ định nhiều cơ sở lưu trú trong một <Item>, giá trị của <MultipleItineraries> trong <QueryControl> phải được đặt thành "affected_dates".

Đối với mỗi ví dụ nêu trên, Google sẽ phản hồi bằng một <Query>, sau đó bạn nên phản hồi bằng một <Transaction> có chứa thông tin cập nhật về giá của các khách sạn/hành trình được chỉ định.

`<HintRequest>`

Thành phần gốc của thông báo Yêu cầu gợi ý. Google sẽ gửi thông báo Yêu cầu gợi ý đến máy chủ của bạn và bạn sẽ nhận được phản hồi chỉ định những khách sạn và hành trình có giá đã thay đổi kể từ lần gần nhất Google nhận được Phản hồi gợi ý thành công từ máy chủ của bạn.

Nếu có thay đổi về giá, Google sẽ gửi một <Query> để tìm nạp dữ liệu giá mới cho các khách sạn và hành trình đã chỉ định.

Để biết thêm thông tin, hãy tham khảo bài viết Thông báo Yêu cầu gợi ý.

Cú pháp

Phần tử <HintRequest> sử dụng cú pháp sau:

Cú pháp

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

Thuộc tính

Phần tử <HintRequest> không có thuộc tính nào.

Phần tử con

Phần tử <HintRequest> có các phần tử con như sau:

Thành phần con	Loại	Nội dung mô tả
<LastFetchTime>	DateTime	Lần gần đây nhất mà Google nhận được thông báo Phản hồi gợi ý cho thông báo Yêu cầu gợi ý. Nếu thời điểm này cũ hơn thời điểm gần nhất bạn cập nhật giá trên máy chủ của mình, thì bạn nên phản hồi bằng thông báo Phản hồi gợi ý nêu rõ khách sạn nào đã thay đổi. Nếu gần đây không có lượt tìm nạp thành công nào, thì giá trị này sẽ được đặt thành một giá trị khoảng thời gian cố định (để tránh các vấn đề nghiêm trọng hơn với lượng tồn đọng lớn). Giá trị khoảng thời gian cố định hiện tại là 1000 giây, nhưng có thể thay đổi. Để biết thêm thông tin, hãy tham khảo bài viết Thông báo Phản hồi gợi ý.

Thành phần con

Loại

Nội dung mô tả

DateTime

Lần gần đây nhất mà Google nhận được thông báo Phản hồi gợi ý cho thông báo Yêu cầu gợi ý.

Nếu thời điểm này cũ hơn thời điểm gần nhất bạn cập nhật giá trên máy chủ của mình, thì bạn nên phản hồi bằng thông báo Phản hồi gợi ý nêu rõ khách sạn nào đã thay đổi.

Nếu gần đây không có lượt tìm nạp thành công nào, thì giá trị này sẽ được đặt thành một giá trị khoảng thời gian cố định (để tránh các vấn đề nghiêm trọng hơn với lượng tồn đọng lớn). Giá trị khoảng thời gian cố định hiện tại là 1000 giây, nhưng có thể thay đổi.

Để biết thêm thông tin, hãy tham khảo bài viết Thông báo Phản hồi gợi ý.

Ví dụ

Ví dụ sau đây cho thấy một thông báo Yêu cầu gợi ý:

Thông báo Yêu cầu gợi ý

Ví dụ sau đây cho thấy một thông báo Yêu cầu gợi ý:

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

Phần tử gốc của thông báo Query. Query tin nhắn là những yêu cầu từ Google về việc cập nhật giá hoặc siêu dữ liệu. Các chế độ này được dùng với cả chế độ phân phối chế độ phân phối Giá lấy dữ liệu và Giá đã thay đổi.

Có ba loại thông báo Query:

Cung cấp mức giá hiện tại: Google phản hồi một yêu cầu cụ thể của người dùng, đề nghị họ cập nhật giá theo thời gian thực. Khi nhận được thông báo Live pricing query, đối tác cần trả lời bằng thông báo <Transaction> có chứa thông tin bắt buộc về giá trong các phần tử <Result>.

Lưu ý quan trọng: Do trải nghiệm Tìm kiếm mới, Truy vấn trực tiếp không còn dùng được cho người dùng ở Khu vực kinh tế Châu Âu (EEA).
Với giá theo bối cảnh: Google cập nhật bộ nhớ đệm về giá dựa trên các bối cảnh phổ biến trước đây. Khi nhận được thông báo With context query, bạn nên trả lời bằng thông báo <Transaction> chứa thông tin về giá được yêu cầu trong các phần tử <Result>.
Siêu dữ liệu: Google yêu cầu thông tin cập nhật về siêu dữ liệu về phòng và Gói dịch vụ phòng của các khách sạn được chỉ định. Khi nhận được thông báo Metadata Query, bạn nên phản hồi bằng thông báo <Transaction> nêu rõ dữ liệu về phòng và Gói dịch vụ phòng trong các phần tử <PropertyDataSet>.

Để biết thêm thông tin, hãy tham khảo bài viết Tổng quan về giá đối với các truy vấn về giá và siêu dữ liệu của Gói dịch vụ phòng đối với các truy vấn siêu dữ liệu.

Dưới đây là cú pháp cho 3 loại này.

Cú pháp

Phần tử <Query> sử dụng cú pháp sau:

Cung cấp mức giá hiện tại

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

Có bối cảnh

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

Metadata

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

Thuộc tính

Phần tử <Query> có thể chứa một thuộc tính: latencySensitive.

Thuộc tính latencySensitive là không bắt buộc. Khi được cung cấp và đặt thành true, giá trị này cho biết truy vấn là Live Pricing Query. Để yêu cầu Google gửi các truy vấn với thuộc tính latencySensitive, vui lòng hỏi Nhà quản lý tài khoản hỗ trợ kỹ thuật (TAM) của bạn.

Phần tử con

Phần tử <Query> có các phần tử con như sau:

Thành phần con	Loại truy vấn	Loại	Nội dung mô tả
<AffectedNights>	Pricing	integer	Số đêm cho thời gian lưu trú theo phạm vi ngày. Phần tử này chỉ được dùng cho những truy vấn về giá của Thời gian lưu trú theo phạm vi ngày sử dụng chế độ phân phối Mức giá đã thay đổi.
<Checkin>	Pricing	Date	Ngày thay đổi giá cụ thể.
<Context>	Pricing (Live Pricing Queries only)	<Context>	Đối với Truy vấn giá hiện tại, hãy chỉ định một số tham số nhất định mà theo đó truy vấn được thực hiện. Các phần tử con bao gồm: `<Occupancy>`: tổng số khách `<OccupancyDetails>`: loại khách, chẳng hạn như người lớn hoặc trẻ em `<UserCountry>`: quốc gia nơi người dùng đang sinh sống `<UserDevice>`: loại thiết bị mà khách đã sử dụng để tìm kiếm khách sạn, chẳng hạn như `"mobile`, "`tablet`" hoặc "`desktop`". Phần tử `<Context>` có thể được lặp lại trong một yêu cầu, cho phép truy vấn nhiều mức sức chứa. Hãy tham khảo `<Context>` để biết danh sách các phần tử con, cú pháp và ví dụ.
<FirstDate>	Pricing	Date	Ngày bắt đầu của phạm vi các hành trình có áp dụng mức giá này. Phần tử này chỉ dùng cho các truy vấn giá của Phạm vi ngày nhận phòng được sử dụng với chế độ Mức giá đã thay đổi.
<HotelInfoProperties>	Metadata	string	Một hoặc nhiều cơ sở lưu trú mà Google muốn cập nhật siêu dữ liệu về phòng và Gói dịch vụ phòng trong một thông báo `Query` siêu dữ liệu. Phần tử này có thể chứa một hoặc nhiều phần tử `<Property>` chỉ định mã cơ sở lưu trú khách sạn.
<LastDate>	Pricing	Date	Ngày kết thúc của phạm vi các hành trình có áp dụng mức giá này. Phần tử này chỉ dùng cho các truy vấn giá của Phạm vi ngày nhận phòng sử dụng tính năng Lấy dữ liệu + Gợi ý.
<Nights>	Pricing	integer	Số đêm trong một hành trình cụ thể, tối đa 30 đêm.
<PropertyList>	Pricing	Object	Một hoặc nhiều mã của khách sạn cần phải cập nhật giá. Hãy xác định từng khách sạn bằng phần tử `<Property>`. Giá trị này là một chuỗi khớp với một mã khách sạn trong Danh sách khách sạn của bạn. Ví dụ: <PropertyList> <Property>pid1</Property> <Property>pid2</Property> </PropertyList>

Ví dụ

Cụm từ tìm kiếm về giá

Dưới đây là ví dụ về thông báo Truy vấn giá yêu cầu thông tin cập nhật về giá đối với một nhóm khách sạn, áp dụng cho 3 đêm và bắt đầu từ ngày 10 tháng 6 năm 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>

Cụm từ tìm kiếm về chế độ cung cấp mức giá hiện tại

Ví dụ sau đây cho thấy một Truy vấn giá hiện tại có giới hạn thời gian phản hồi là 500 mili giây:

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

Có truy vấn theo ngữ cảnh

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

Truy vấn siêu dữ liệu

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

Để xem thêm ví dụ, trong đó có các truy vấn về giá của thời gian lưu trú theo phạm vi ngày và phạm vi ngày nhận phòng, hãy xem ví dụ về thông báo Query.

`<Context>`

Phần tử <Context> mô tả thông tin của Live pricing query, bao gồm số lượng và loại khách, quốc gia của người dùng và thiết bị của người dùng.

Không bao giờ dùng nhiều <Context> với nhiều quốc gia của người dùng hoặc thiết bị của người dùng. Khi dùng nhiều <Context> để truy vấn nhiều mức sức chứa, vui lòng cung cấp giá của từng số người lưu trú dưới dạng một Gói dịch vụ phòng bổ sung cho cơ sở lưu trú/hành trình tương ứng. Mỗi cơ sở lưu trú/hành trình phải có một khối <Result> duy nhất kèm theo giá cho nhiều mức sức chứa.

Để biết thông tin chi tiết về phản hồi cho truy vấn <Context>, hãy xem <OccupancyDetails>.

Cú pháp

Phần tử <Context> sử dụng cú pháp sau:

Cú pháp

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

Phần tử con

Phần tử <Context> có các phần tử con như sau:

Thành phần con	Loại truy vấn	Loại	Nội dung mô tả
<Occupancy>	Pricing	integer	Xác định tổng số khách. Mặc dù không bắt buộc, các truy vấn có `<Occupancy>` sẽ dẫn đến một thông báo giao dịch có các Gói dịch vụ phòng thích hợp được xác định cho mỗi `<Occupancy>` được truy vấn. Lưu ý:`<Occupancy>` không phải lúc nào cũng xuất hiện trong truy vấn. Trong những trường hợp như vậy, bạn nên trả về giá của tất cả số người lưu trú.
<OccupancyDetails>	Pricing	Object	Theo sau là `<Occupancy>`. Chỉ định khách theo loại, bao gồm: `<NumAdults>`: số lượng khách người lớn `<Children>` và `<Child="age">`: Xác định khách nào là trẻ em (thường từ 0 đến 17 tuổi) và có thể bao gồm độ tuổi của từng trẻ. Mặc dù không bắt buộc, các truy vấn có `<OccupancyDetails>` sẽ dẫn đến một thông báo giao dịch có các Gói dịch vụ phòng thích hợp được xác định cho mỗi `<Occupancy>` được truy vấn. Lưu ý: `<OccupancyDetails>` không phải lúc nào cũng xuất hiện trong truy vấn. Trong những trường hợp như vậy, bạn nên giả định rằng tất cả khách đều là người lớn.
<UserCountry>	Pricing	string	Lọc đơn giá theo quốc gia nơi người dùng đang có mặt. Giá trị này là một mã quốc gia gồm 2 chữ cái, chẳng hạn như `“US”` để chỉ Hoa Kỳ hoặc mã vùng, chẳng hạn như `"EU"` để chỉ "Châu Âu". Các truy vấn có `<UserCountry>` được xác định sẽ dẫn đến một thông báo giao dịch có khối `<Rates>` thích hợp được xác định cho quốc gia được truy vấn.
<UserDevice>	Pricing	string	Lọc đơn giá theo loại thiết bị mà người dùng sử dụng để tìm kiếm. Các loại tệp có thể được thu thập dữ liệu bao gồm: `mobile` `desktop` `tablet` Các truy vấn có `<UserDevice>` được xác định sẽ dẫn đến một thông báo giao dịch có khối `<Rates>` thích hợp được xác định cho loại thiết bị được truy vấn.

Ví dụ

Người trong nhà

Ví dụ sau đây cho thấy một Truy vấn về chế độ cung cấp giá hiện tại cho <Occupancy> trong phạm vi <Context>. Truy vấn mức giá hiện tại dành cho 3 khách người lớn.

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

Thông tin về người lưu trú

Ví dụ sau đây cho thấy một Truy vấn về chế độ cung cấp giá hiện tại có <OccupancyDetails> trong <Context>. Truy vấn mức giá hiện tại dành cho 4 khách, 2 trong số đó là trẻ em và đang tìm một mức giá áp dụng cho yêu cầu đặt phòng ở Hoa Kỳ dành cho khách trên thiết bị di động:

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

Nhiều ngữ cảnh

Ví dụ sau đây cho thấy việc sử dụng phần tử <Context> bổ sung trong một Truy vấn cung cấp mức giá hiện tại.

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

Tài liệu tham khảo XML về truy vấn & Gợi ý

<Hint> (thông báo Phản hồi gợi ý)

Cú pháp

Hành trình chính xác

Phạm vi ngày nhận phòng

Thời gian lưu trú theo phạm vi ngày

Thuộc tính

Phần tử con

Ví dụ

Hành trình chính xác

Phạm vi ngày nhận phòng

Thời gian lưu trú theo phạm vi ngày

<HintRequest>

Cú pháp

Cú pháp

Thuộc tính

Phần tử con

Ví dụ

Thông báo Yêu cầu gợi ý

<Query>

Cú pháp

Cung cấp mức giá hiện tại

Có bối cảnh

Metadata

Thuộc tính

Phần tử con

Ví dụ

Cụm từ tìm kiếm về giá

Cụm từ tìm kiếm về chế độ cung cấp mức giá hiện tại

Có truy vấn theo ngữ cảnh

Truy vấn siêu dữ liệu

<Context>

Cú pháp

Cú pháp

Phần tử con

Ví dụ

Người trong nhà

Thông tin về người lưu trú

Nhiều ngữ cảnh

`<Hint>` (thông báo Phản hồi gợi ý)

`<HintRequest>`

`<Query>`

`<Context>`