Thông báo Phản hồi gợi ý

Khi Google gửi thông báo Yêu cầu gợi ý, máy chủ của bạn sẽ phản hồi bằng thông báo Phản hồi gợi ý. Thông báo này xác định những khách sạn đã thay đổi giá kể từ lần gần đây nhất Google nhận được Phản hồi gợi ý thành công từ các máy chủ đó. Nếu có bất kỳ thay đổi nào về giá, Google sẽ gửi <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ông tin tổng quan về quy trình đặt giá lại, hãy xem bài viết Tổng quan về giá.

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

Thành phần gốc của thông báo Phản hồi gợi ý là <Hint>. Bạn có thể yêu cầu cập nhật khách sạn hoặc hành trình bằng một hoặc nhiều phần tử <Item>. Một thông báo Phản hồi gợi ý duy nhất có thể xác định vô số phần tử <Item>.

Mỗi thông báo Phản hồi gợi ý phải chỉ định ít nhất một phần tử <Property> cho mỗi <Item>. <Property> xác định khách sạn bằng cách sử dụng cùng một mã với Danh sách khách sạn. Theo mặc định, bạn sẽ chỉ định một mã khách sạn duy nhất cho mỗi khối <Item>. Tuy nhiên, bạn có thể hướng dẫn để Google cho phép nhiều khách sạn trong một khối nếu bạn đang sử dụng phạm vi ngày nhận phòng hoặc thời gian lưu trú theo phạm vi ngày để định giá lại.

Quy trình yêu cầu và phản hồi đối với hành trình chính xác

Thông báo gợi ý có thể dựa trên các hành trình riêng lẻ, chẳng hạn như tổ hợp ngày nhận phòng và thời gian lưu trú. Trong trường hợp này, bạn cần chỉ định ngày nhận phòng và thời gian lưu trú cho khách sạn của mình và Google sẽ tìm nạp dữ liệu giá mới cho riêng hành trình đó.

Phản hồi của đối tác

Thông báo Phản hồi gợi ý sau đây xác định một cơ sở lưu trú và một hành trình duy nhất:

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Phản hồi của Google

Google sẽ phản hồi thông báo Phản hồi gợi ý của bạn bằng <Query> tương tự như sau:

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Tạo <Transaction>

Sau đó, bạn cần tạo một <Transaction> kèm theo thông tin cập nhật về giá của khách sạn cho lần lưu trú sau đây:

5/20/23 - 5/23/23

Quy trình yêu cầu và phản hồi đối với phạm vi ngày nhận phòng

Thông báo Phản hồi gợi ý có thể chỉ định nhiều ngày nhận phòng, bắt đầu bằng 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. Khi tìm nạp dữ liệu giá mới, Google sẽ thu thập các hành trình cho mỗi ngày nhận phòng của khách sạn, bắt đầu từ các ngày đó cho đến thời gian lưu trú mà bạn chỉ định.

Phạm vi ngày của đối tác

Ví dụ sau đây về thông báo Phản hồi gợi ý xác định một cơ sở lưu trú duy nhất kèm theo phạm vi ngày nhận phòng:

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

Phản hồi của Google

Google sẽ phản hồi thông báo Phản hồi gợi ý này bằng <Query> tương tự như sau:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

Tạo <Transaction>

Sau đó, bạn cần tạo một <Transaction> kèm theo thông tin cập nhật về giá cho các lần lưu trú sau đây của khách sạn đó:

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/20/23 - 5/24/23
5/20/23 - 5/25/23

5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/21/23 - 5/25/23
5/21/23 - 5/26/23

5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/22/23 - 5/26/23
5/22/23 - 5/27/23

Ví dụ này sử dụng thời gian lưu trú là 5 đêm. Thời gian lưu trú mặc định là 30 ngày.

Quy trình yêu cầu và phản hồi đối với thời gian lưu trú theo phạm vi ngày

Thông báo Phản hồi gợi ý có thể bao gồm một phạm vi ngày đã thay đổi. Thông tin này giúp Google biết rằng Google cần tìm nạp mọi hành trình chịu ảnh hưởng của bất kỳ ngày nào trong số đó. Tập hợp hành trình thực tế được tìm nạp là một hàm gồm cả tập hợp các ngày có thay đổi và thời gian lưu trú tối đa.

Thời gian lưu trú theo phạm vi ngày của đối tác

Thông báo Phản hồi gợi ý mẫu sau đây sử dụng thời gian lưu trú theo phạm vi ngày:

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

Phản hồi của Google

Google sẽ phản hồi thông báo Phản hồi gợi ý của bạn bằng <Query> tương tự như sau:

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

Tạo <Transaction>

Sau đó, bạn cần tạo một <Transaction> kèm theo thông tin cập nhật về giá của khách sạn cho các lần lưu trú sau đây:

5/17/23 - 5/20/23

5/18/23 - 5/20/23
5/18/23 - 5/21/23

5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23

5/21/23 - 5/22/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

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23