Thông báo truy vấn

Thông báo truy vấn là những yêu cầu mà Google gửi để cập nhật giá hoặc siêu dữ liệu. Những thông báo này được sử dụng với cả chế độ phân phối Giá thu thập và Giá đã thay đổi delivery modes.

Phần tử gốc của Thông báo truy vấn là <Query>.

Cấu trúc của Thông báo truy vấn tùy thuộc vào loại thông báo:

• Giá: Google gửi Thông báo truy vấn để yêu cầu cập nhật giá đối với các khách sạn được chỉ định.

• Siêu dữ liệu: Google gửi Thông báo truy vấn để yêu cầu cung cấp dữ liệu về thông tin phòng và gói dịch vụ của các khách sạn được chỉ định.

Bạn xác định điểm cuối mà Google sử dụng cho Thông báo truy vấn và Truy vấn giá hiện tại trong quá trình định cấu hình ban đầu. Để biết thêm thông tin, hãy liên hệ với Nhà quản lý tài khoản hỗ trợ kỹ thuật (TAM) của bạn.

Google gửi Thông báo truy vấn dưới dạng yêu cầu HTTP POST có tiêu đề Content-Type đặt thành "application/xml" và tiêu đề User-Agent đặt thành Google-HotelAdsPrices. Ngoại lệ của quy tắc này xảy ra trong quá trình kiểm tra thủ công hoạt động tích hợp điểm cuối về giá qua Google-TravelAds-Live. Các truy vấn mẫu đó có thể chứa hoặc không chứa tiêu đề User-Agent.

Bạn có thể xem định dạng chi tiết của Thông báo truy vấn trong Tài liệu tham khảo về truy vấn XML.

Thông báo truy vấn giá

Thông báo truy vấn giá chỉ định các tổ hợp cơ sở lưu trú và hành trình cần bạn cung cấp giá.

Khi nhận được Thông báo truy vấn giá, máy chủ của bạn sẽ phản hồi bằng thông báo <Transaction> chứa thông tin về giá được yêu cầu cung cấp.

Để biết thêm thông tin, hãy xem bài viết Tổng quan về giá.

Có 3 loại thông báo Truy vấn đặc biệt:

1. Cung cấp mức giá hiện tại: Nếu được bật, các truy vấn sẽ được gửi khi người dùng đang tích cực duyệt xem giá của tổ hợp cơ sở lưu trú hoặc hành trình được chỉ định và bạn có một khoảng thời gian cụ thể để phản hồi.

2. Theo bối cảnh: Nếu được bật, các đề xuất về bối cảnh của người dùng sẽ được đưa vào mỗi truy vấn mà Google gửi cho bạn và các đề xuất này phản ánh những loại người dùng phổ biến nhất tìm kiếm tổ hợp cơ sở lưu trú hoặc hành trình đã cho. Việc làm theo các đề xuất này có thể giúp tăng hiệu quả của phản hồi.

3. Siêu dữ liệu: Đây là yêu cầu cung cấp thông tin chi tiết về phòng và gói dịch vụ của các cơ sở lưu trú được chỉ định.

Truy vấn giá hiện tại

Truy vấn cung cấp mức giá hiện tại là những yêu cầu mà Google gửi để cập nhật giá theo thời gian thực nhằm phản hồi những lượt tìm kiếm của người dùng. Google nhận được yêu cầu tìm kiếm tổ hợp khách sạn hoặc hành trình từ người dùng và do dữ liệu giá không có sẵn hoặc không phải là dữ liệu mới nhất nên Google yêu cầu bạn cập nhật giá tại thời điểm tìm kiếm. Với tính năng cung cấp mức giá hiện tại, Google cố gắng lấy giá và hiển thị giá đó trong các kết quả tại thời điểm tìm kiếm.

Tất cả các yêu cầu truy vấn cung cấp mức giá hiện tại đều có giới hạn thời gian phản hồi, thường lên tới 4.000 mili giây. Giới hạn này được nêu rõ trong yêu cầu truy vấn cung cấp mức giá hiện tại. Nếu không có phản hồi trong thời gian giới hạn, cơ hội đấu giá sẽ bị bỏ lỡ. Tuy nhiên, bạn vẫn nên cung cấp giá để có thể lưu giá này vào bộ nhớ đệm và sử dụng cho các cơ hội trong tương lai. Kết nối để phản hồi sẽ tiếp tục mở trong 10 phút hoặc như được chỉ định trong cấu hình của đối tác.

Truy vấn cung cấp mức giá hiện tại cũng theo bối cảnh và có thể truy xuất giá theo các tham số sau: quốc gia của người dùng, loại thiết bị, số người lưu trú (số lượng khách lưu trú) và liệu những khách lưu trú này là người lớn hay trẻ em. Với tính năng cung cấp mức giá hiện tại, bạn có thể hiển thị mức giá đã cập nhật hơn, phù hợp với nội dung khách hàng tìm kiếm.

Truy vấn cung cấp mức giá hiện tại là cơ chế phụ để cập nhật giá. Cơ chế chính để đặt lại giá vẫn là thông qua Giá thu thập hoặc mức giá đã thay đổi. Truy vấn cung cấp mức giá hiện tại giúp bổ sung giá còn thiếu trong trường hợp Google không có giá của tổ hợp khách sạn hoặc hành trình.

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

<?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/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

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

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