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. Các thông tin này được dùng với cả chế độ phân phối Giá thu thập và Mức giá đã thay đổi.

Thành phần 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 phụ 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á cho 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ề phòng và gói dịch vụ trong 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).

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

Thông báo Truy vấn giá cho biết những tổ hợp cơ sở lưu trú hoặc hành trình mà bạn cung cấp giá.

Khi nhận được Thông báo truy vấn pricing, 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.

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

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

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

2. Có bối cảnh: Nếu được bật, nội dung đề xuất theo 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 kiểu người dùng phổ biến nhất tìm kiếm các tổ hợp cơ sở lưu trú hoặc hành trình nhất định. Việc làm theo các đề xuất này có thể giúp tăng hiệu quả 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ề các phòng và gói dịch vụ cho các cơ sở lưu trú được chỉ định.

Truy vấn về chế độ cung cấp mức giá hiện tại

Truy vấn về chế độ cung cấp giá hiện tại là những yêu cầu của Google nhằm cập nhật giá theo thời gian thực theo các lượt tìm kiếm của người dùng. Google nhận được yêu cầu tìm kiếm của người dùng về một tổ hợp khách sạn hoặc hành trình. Do chưa có dữ liệu về giá nên Google sẽ yêu cầu bạn cập nhật giá tại thời điểm tìm kiếm. Thông qua truy vấn về chế độ Cung cấp mức giá hiện tại, Google cố gắng lấy giá và hiển thị mức giá đó trong kết quả tại thời điểm người dùng tìm kiếm.

Tất cả các yêu cầu truy vấn 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 chỉ định trong yêu cầu Truy vấn mức giá hiện tại. Nếu không thể đưa ra câu trả lời trong thời gian giới hạn, thì 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á đó vào bộ nhớ đệm và sử dụng cho các cơ hội trong tương lai. Kết nối cho phản hồi sẽ vẫn mở trong 10 phút hoặc như được chỉ định trong cấu hình của đối tác.

Truy vấn giá hiện tại cũng theo bối cảnh và có thể truy xuất giá cho 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ố khách) và liệu khách đó là người lớn hay trẻ em. Khi dùng Truy vấn mức giá hiện tại, bạn có thể đăng mức giá mới nhất và phù hợp với giá mà khách hàng tìm kiếm.

Truy vấn cung cấp giá hiện tại là cơ chế phụ để cập nhật giá. Cơ chế chính để định giá lại vẫn là thông qua chế độ phân phối giá Lấy dữ liệu hoặc Giá đã thay đổi. Truy vấn về giá hiện tại giúp bổ sung dữ liệu còn thiếu khi Google không có giá cho các tổ hợp khách sạn hoặc hành trình.

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 hoạt động khi người dùng ở một quốc gia trong Khu vực kinh tế Châu Âu (EEA) và đưa ra một truy vấn điều hướng (dành riêng cho khách sạn) có ngày hoặc ngày thay đổi trên trang kết quả tìm kiếm.

Quy tắc sử dụng Truy vấn mức giá hiện tại

• Không có dữ liệu nào được lưu vào bộ nhớ đệm cho hành trình đã chọn vì hành trình được yêu cầu không phải là lịch trình thường xuyên, chẳng hạn như ngày rất xa trong tương lai hoặc khách sạn rất hiếm khi được tìm kiếm.

• Ngày được yêu cầu không phải là ngày mặc định.

: Lưu ý: Ngày mặc định không đủ điều kiện cho Truy vấn cung cấp giá hiện tại. Truy vấn về giá hiện tại chỉ được yêu cầu đối với những ngày không phải ngày mặc định.

Google thường lưu kết quả của Chế độ cung cấp mức giá hiện tại vào bộ nhớ đệm để người dùng không truy vấn lại cùng một khách sạn hoặc hành trình. Loại phòng này có thể yêu cầu cả tổ hợp khách sạn đơn lẻ hoặc hành trình lưu trú cũng như tổ hợp nhiều hành trình hoặc khách sạn.

Tính năng Cung cấp mức giá hiện tại theo bối cảnh cho phép Google gửi các yêu cầu cung cấp mức giá hiện tại cụ thể dựa trên loại thiết bị của người dùng, quốc gia nơi họ đang tìm kiếm và số lượng người lưu trú bao gồm cả trẻ em. Cả Thông báo truy vấn và Thông báo giao dịch đều được mở rộng để bao gồm phần tử <Context> xác định các tham số truy vấn. Giá nhận được qua các truy vấn về Giá hiện tại có bối cảnh có thể được lưu vào bộ nhớ đệm dưới dạng Gói dịch vụ phòng, nếu đó là giá cho một số người lưu trú cụ thể và dưới dạng Giá phòng có điều kiện, nếu giá đó dành cho quốc gia của người dùng hoặc thiết bị của người dùng.

Truy vấn theo bối cảnh

Truy vấn Có bối cảnh là những yêu cầu thông thường để cập nhật cơ sở dữ liệu của chúng tôi đối với những tổ hợp cơ sở lưu trú hoặc hành trình được chỉ định. Các đối tượng này chứa danh sách các ngữ cảnh người dùng phổ biến đối với những cách kết hợp đó. Nếu bạn sử dụng Mức giá có điều kiện, thì việc gửi giá cho mọi ngữ cảnh có thể có của người dùng có thể sẽ tốn kém. Do đó, bạn có thể sử dụng danh sách bối cảnh người dùng này để giới hạn câu trả lời của mình. Giá trả về chỉ cho ngữ cảnh người dùng được chỉ định bao gồm phần lớn các truy vấn có liên quan của người dùng.

Lưu ý quan trọng: Nếu bạn muốn nhận các câu hỏi theo bối cảnh, vui lòng liên hệ với Nhà quản lý tài khoản hỗ trợ kỹ thuật (TAM) của bạn. Họ có thể xác nhận rằng bạn đã sẵn sàng nhận các thông báo như vậy, sau đó điều chỉnh cấu hình để bắt đầu gửi ngữ cảnh người dùng trong các truy vấn cho bạn.

Thông báo truy vấn siêu dữ liệu

Thông báo truy vấn siêu dữ liệu chứa 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.

Khi nhận được Thông báo truy vấn siêu dữ liệu, bạn phải trả lời bằng thông báo <Transaction> nêu rõ giá của các cơ sở lưu trú được yêu cầu trong phần tử <Result>.

Để biết thêm thông tin, hãy xem bài viết Xác định siêu dữ liệu về phòng và gói dịch vụ.

Kiểm soát truy vấn

Phần này mô tả cách bạn kiểm soát những cơ sở lưu trú và hành trình có thể trở thành đối tượng của Thông báo truy vấn của Google.

Ranh giới hành trình

Bạn xác định các ranh giới có thể có của truy vấn đặt giá bằng cách sử dụng <ItineraryCapabilities>. Bạn xác định các quy tắc giúp xác định phạm vi ngày và thời gian lưu trú tối đa mà bạn hỗ trợ.

Bạn có thể đặt giá trị mặc định cho <MaxAdvancePurchase> và <MaxLengthOfStay>, áp dụng cho tất cả tổ hợp khách sạn hoặc hành trình. Bạn cũng có thể xác định các chế độ cài đặt này cho các nhóm khách sạn.

Ví dụ về thông báo truy vấn

Phần này trình bày một số ví dụ về Thông báo truy vấn giá và Thông báo truy vấn siêu dữ liệu. Bạn có thể xem thêm ví dụ trong Tài liệu tham khảo về truy vấn XML.

Hành trình mẫu

Ví dụ sau đây thể hiện <Query> về giá yêu cầu cập nhật giá cho 4 khách sạn, áp dụng cho 3 đêm và bắt đầu từ ngày 23 tháng 5 năm 2023:

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

Ví dụ sau đây yêu cầu cập nhật giá cho từng khách sạn:

5/23/18 - 6/26/18

Ví dụ về truy vấn cung cấp mức giá hiện tại

Ví dụ sau đây cho thấy một truy vấn Cung cấp 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">
<!-- 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>

Ví dụ sau đây về yêu cầu giá cho một khách sạn:

6/23/23 - 6/25/23

Bạn có thể tìm thấy phản hồi mẫu cho thông báo giao dịch cho truy vấn này trong Tài liệu tham khảo XML về Giá và quỹ phòng (Giao dịch).

Ví dụ về truy vấn theo bối cảnh

Ví dụ sau đây là một ví dụ về truy vấn Có bối 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>

Với các truy vấn Ngữ cảnh chỉ xác định bối cảnh quốc gia của người dùng. Trong tương lai, các truy vấn đó cũng có thể chỉ định thiết bị của người dùng và số người lưu trú.

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

Nếu bạn sử dụng chế độ Mức giá đã thay đổi, thì cấu trúc của Thông báo truy vấn phụ thuộc vào loại gợi ý mà bạn dùng cho phạm vi ngày nhận phòng, hành trình chính xác hoặc hành trình theo phạm vi ngày. Để biết thêm thông tin về từng loại gợi ý này, hãy xem bài viết Thông báo Phản hồi gợi ý.

Ví dụ sau đây cho thấy một thông báo <Query> về giá cho phạm vi ngày nhận phòng:

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

Ví dụ này yêu cầu cập nhật giá cho các lần lưu trú dưới đây (đối với mỗi khách sạn):

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

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

Ví dụ sau đây cho thấy một thông báo <Query> về giá cho thời gian lưu trú theo phạm vi ngày:

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

Ví dụ sau đây yêu cầu cập nhật giá cho từng khách sạn:

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

Ngoài ra, những lượt lưu trú đã bắt đầu trước (nhưng bao gồm) đêm đã chọn:

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

Thông báo truy vấn siêu dữ liệu

Ví dụ sau đây cho thấy một thông báo <Query> yêu cầu thông tin cập nhật siêu dữ liệu về phòng và gói dịch vụ của một số cơ sở lưu trú:

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

Bạn sẽ phản hồi loại Thông báo truy vấn này bằng thông báo Giao dịch xác định siêu dữ liệu về phòng và gói dịch vụ. Để biết thêm thông tin, hãy xem phần Xác định siêu dữ liệu về phòng và gói dịch vụ.