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

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. Chúng được sử dụng cùng với cả chế độ phân phối Giá lấy dữ liệu và Mức giá đã thay đổi chế độ phân phố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à thông tin về gói 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à Sự kiện phát trực tiếp Truy vấn giá trong quá trình định cấu hình ban đầu. Để biết thêm thông tin, 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 HTTP POST kèm theo Content-Type tiêu đề được đặt thành "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 tra thủ công việc tích hợp thiết bị đầu cuối về giá thông qua Google-TravelAds-Live. Mẫu đó các truy vấn 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á chỉ định những kiểu kế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 giá, máy chủ của bạn sẽ phản hồi bằng một thông báo 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:

Cung cấp mức giá hiện tại: Nếu bạn bật chế độ này, các truy vấn sẽ được gửi khi người dùng đang hoạt động đang duyệt xem giá cho tổ hợp cơ sở lưu trú hoặc hành trình được chỉ định, sau đó bạn có khung thời gian cụ thể để phản hồi.
Có bối cảnh: Nếu bạn bật tuỳ chọn này, các đề xuất về bối cảnh cho người dùng sẽ được đưa vào trong mỗi truy vấn mà Google gửi cho bạn và các đề xuất phản ánh những kiểu người dùng phổ biến tìm thông tin về cơ sở lưu trú hoặc hành trình cụ thể kết hợp. Việc làm theo các đề xuất này có thể làm tăng hiệu quả của phản hồi của bạn.
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ụ cho các thuộc tính cụ thể.

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

Truy vấn về giá hiện tại là những yêu cầu của Google để cập nhật giá theo thời gian thực ở cho các cụm từ tìm kiếm của người dùng. Google nhận được yêu cầu tìm kiếm từ người dùng cho một tổ hợp khách sạn hoặc hành trình, và do không có dữ liệu giá hiện tại, Google sẽ yêu cầu bạn cập nhật giá tại thời điểm tìm kiếm. Bằng Khi truy vấn về chế độ cung cấp mức giá hiện tại, Google sẽ cố gắng lấy giá rồi đăng mức giá đó trong kết quả vào thời điểm 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à lên đến 4000 mili giây. Hạn mức này được chỉ định trong truy vấn Cung cấp mức giá hiện tại của bạn. Nếu không thể đưa ra câu trả lời trong thời gian giới hạn, thì điều này sẽ dẫn đến việc việc bỏ lỡ cơ hội đấu giá. Tuy nhiên, bạn nên vẫn cung cấp một mức giá để có thể lưu 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 đượ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 dựa trên bối cảnh và có thể truy xuất giá của các các thông 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 vị 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ể có thể hiển thị những mức giá mới hơn phù hợp với giá mà 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ụ để định giá bản cập nhật. Cơ chế chính để định giá lại vẫn là thông qua phương thức Lấy dữ liệu hoặc Đã thay đổi giá. Truy vấn về chế độ cung cấp mức giá hiện tại giúp bổ sung dữ liệu còn thiếu mà Google không có giá cho các tổ hợp khách sạn hoặc hành trình.

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

Không có dữ liệu được lưu vào bộ nhớ đệm cho hành trình đã chọn do hành trình được yêu cầu không điển hình, chẳng hạn như ngày rất xa trong tương lai hoặc khách sạn rất xa ít được tìm kiếm hơn.
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. Trực tiếp chỉ yêu cầu truy vấn giá cho các 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 để khách sạn hoặc hành trình không được truy vấn lại. Có thể yêu cầu cả khách sạn đơn lẻ hoặc hành trình cũng như các kiểu kế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 thông tin cụ thể Yêu cầu cung cấp mức giá hiện tại dựa trên loại thiết bị của người dùng, quốc gia mà từ đó họ đang tìm kiếm, cũng như số người lưu trú, bao gồm cả trẻ em. Cả hai thuộc tính Thông báo truy vấn và thông báo Giao dịch được mở rộng để bao gồm Phần tử <Context> xác định các tham số truy vấn. Giá đã nhận từ Những 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à là Giá phòng có điều kiện, nếu đó là cho quốc gia 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 cho kiểu kết hợp cơ sở lưu trú hoặc hành trình được chỉ định. Chúng chứa danh sách người dùng bối cảnh phổ biến cho những kết hợp đó. Nếu Giá phòng có điều kiện được sử dụng, sau đó là cước gửi cho tất cả ngữ cảnh người dùng có thể có có thể tốn kém, do đó bạn có thể hãy sử dụng danh sách ngữ cảnh người dùng này để giới hạn câu trả lời của bạn. Chỉ áp dụng giá cũ cho bối 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.

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ụ cho các thuộc tính được chỉ định.

Khi nhận được Thông báo truy vấn siêu dữ liệu, bạn nên trả lời bằng một thông báo <Transaction> chỉ định giá cho 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 cơ sở lưu trú và hành trình có thể là chủ thể của Thông báo truy vấn từ 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 giá bằng cách sử dụng <ItineraryCapabilities>. Bạn xác định các quy tắc 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 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à siêu dữ liệu Thông báo truy vấn. Bạn có thể xem thêm các 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 một biểu tượng giá <Query> yêu cầu thông tin cập nhật về giá 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 về chế độ Cung cấp mức giá hiện tại có giới hạn thời gian phản hồi 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 thông báo giao dịch mẫu cho truy vấn này trong Giá và Trang tham khảo XML 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 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, chẳng hạn như 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 sẽ 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 hoặc hành trình theo phạm vi ngày. Để biết thêm thông tin về từng trường hợp các loại gợi ý, hãy xem bài viết Thông báo Phản hồi gợi ý.

Ví dụ sau đây thể hiện một thông báo <Query> giá cho ngày nhận phòng dải ô:

<?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ú sau đây (đối với mỗi lần lưu trú) 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 thể hiện một thông báo <Query> về giá cho phạm vi ngày điểm lưu trú:

<?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 là một thông báo <Query> yêu cầu siêu dữ liệu nội dung cập nhật về 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 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 Xác định siêu dữ liệu về phòng và gói dịch vụ.