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 Lấy dữ liệu và Mức giá đã thay đổi.
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 tuỳ 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 thông tin cập nhật về giá đối với các khách sạn được chỉ định.
Siêu dữ liệu: Google gửi một 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 Giám đốc Quản lý Khách hàng về 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 POST HTTP 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 mà 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.
Để 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:
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á 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 cụ thể để phản hồi.
Có bối cảnh: Nếu được bật, đề xuất theo bối cảnh của người dùng sẽ được đưa vào mỗi cụm từ tìm kiếm 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 các tổ hợp tài sản hoặc hành trình nhất định. Việc làm theo những đề xuất này có thể giúp tăng hiệu quả của câu trả lời.
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 Yêu cầu cung cấp giá hiện tại
Truy vấn 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 truy vấn giá hiện tại, Google cố gắng lấy giá và hiển thị 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 giá hiện tại đều có giới hạn thời gian phản hồi, thường là tối đa 4.000 mili giây. Giới hạn này được chỉ định trong yêu cầu Truy vấn 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 mười 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á theo các thông số sau: quốc gia của người dùng, loại thiết bị, sức chứa (số lượng khách) và liệu những vị khách này là người lớn hay trẻ em. Khi dùng Truy vấn giá hiện tại, bạn có thể đăng mức giá mới nhất phù hợp với giá mà khách hàng tìm kiếm.
Truy vấn 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 Giá đã thay đổi. Truy vấn 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.
Quy tắc sử dụng Truy vấn yêu cầu cung cấp giá hiện tại
Bộ nhớ đệm không có dữ liệu nào về hành trình đã chọn vì hành trình được yêu cầu không phải loại thường gặp, chẳng hạn như ngày rất xa trong tương lai hoặc khách sạn không được tìm nhiều.
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 để thực hiện Truy vấn giá hiện tại. Chỉ yêu cầu truy vấn giá hiện tại cho những ngày không mặc định.
Google thường lưu kết quả của Giá hiện tại vào bộ nhớ đệm để các khách sạn hoặc hành trình lưu trú đó không bị truy vấn lại. Truy vấn này có thể yêu cầu cả tổ hợp khách sạn hoặc hành trình riêng lẻ cũng như tổ hợp nhiều khách sạn hoặc hành trình riêng lẻ.
Tính năng Truy vấn giá hiện tại theo bối cảnh giúp Google gửi các yêu cầu Truy vấn 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ọ tiến hành 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> – phần tử xác định các tham số truy vấn. Giá nhận được từ các truy vấn giá hiện tại theo 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á theo sức chứa cụ thể và dưới dạng Giá phòng có điều kiện, nếu đó là giá theo quốc gia hoặc thiết bị của người dùng.
Với truy vấn theo bối cảnh
Truy vấn theo bối cảnh là những yêu cầu thường xuyên để cập nhật cơ sở dữ liệu của chúng tôi cho tổ hợp cơ sở lưu trú hoặc hành trình được chỉ định. Chúng chứa danh sách các ngữ cảnh người dùng phổ biến cho những tổ hợp đó. Nếu bạn sử dụng Giá có điều kiện, thì việc gửi giá cho tất cả các bối cảnh người dùng có thể có thể 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 phản hồi của mình. Việc chỉ trả về giá cho các ngữ cảnh người dùng được chỉ định sẽ bao gồm phần lớn các cụm từ tìm kiếm có liên quan của người dùng.
Nếu bạn muốn nhận các cụm từ tìm kiếm Có ngữ cảnh, hãy liên hệ với Giám đốc Quản lý Khách hàng về Kỹ thuật (TAM). Họ có thể xác nhận rằng bạn đã sẵn sàng nhận những 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 có thông tin chi tiết về thông tin 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 các 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 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 cung cấp giá bằng cách sử dụng
<ItineraryCapabilities>. Bạn đặt ra những 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ả cá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 nhiều 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 cung cấp 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 minh hoạ một <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ụ nà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 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">
<!-- 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ụ này yêu cầu cung cấp giá cho một khách sạn duy nhất:
6/23/23 - 6/25/23
Bạn có thể xem phản hồi thông báo giao dịch mẫu cho truy vấn này trong Trang tham khảo XML về Giá và quỹ phòng (Giao dịch).
Ví dụ về truy vấn kèm theo bối cảnh
Sau đây là ví dụ về truy vấn Có ngữ cảnh:
Truy vấn cơ bản kèm theo 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, 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 có bối cảnh, bao gồm cả số người lưu trú
<?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>
Với Context, chỉ định bối cảnh quốc gia của người dùng. Trong tương lai, những truy vấn như vậy cũng có thể chỉ định thiết bị của người dùng.
Phạm vi ngày nhận phòng
Nếu bạn sử dụng 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 sử 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 Thông báo Phản hồi gợi ý.
Ví dụ sau thể hiện 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 thể hiện 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ụ nà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
Cộng thêm các 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 thông báo <Query> yêu cầu thông tin cập nhật về siêu dữ liệu cho thông tin 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 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ụ.