힌트 응답 메시지

Google에서 힌트 요청 메시지를 전송하면 서버는 Google이 동일한 서버로부터 마지막으로 힌트 응답을 수신한 이후 가격이 변경된 호텔을 지정하는 힌트 응답 메시지로 응답해야 합니다. 가격이 변경되면 Google에서 지정된 호텔 및 숙박 일정의 업데이트된 가격 데이터를 가져오는 <Query>를 전송합니다.

가격 재조정 절차에 대한 개요는 가격 책정 개요를 참고하세요.

힌트 응답 메시지는 다음 메서드를 사용하여 선택한 호텔 및 숙박 일정의 가격을 다시 책정합니다.

힌트 응답 메시지의 루트 요소는 <Hint>입니다. 하나 이상의 <Item> 요소를 사용하여 호텔 또는 숙박 일정 업데이트를 요청합니다. 단일 힌트 응답 메시지는 <Item> 요소를 원하는 만큼 정의할 수 있습니다.

각 힌트 응답 메시지는 각 <Item>에 대해 하나 이상의 <Property> 요소를 지정해야 합니다. <Property>는 호텔 목록과 동일한 ID를 사용하여 호텔을 식별합니다. 기본적으로 각 <Item> 블록에 하나의 호텔 ID를 지정합니다. 하지만 재가격 책정에 체크인 기간 또는 숙박 기간 범위를 사용하는 경우 Google에 상품 블록에서 여러 호텔을 허용하도록 지시할 수 있습니다.

정확한 숙박 일정 요청 및 응답 흐름

힌트 메시지는 체크인 날짜와 숙박 기간의 조합과 같은 개별 숙박 일정을 기반으로 할 수 있습니다. 이 경우 호텔의 체크인 날짜와 숙박 기간을 지정하면 Google에서 해당 숙박 일정에 대한 새 가격 데이터만 가져옵니다.

파트너의 응답

다음 힌트 응답 메시지는 단일 숙박 시설과 단일 숙박 일정을 정의합니다.

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

Google의 응답

Google은 힌트 응답 메시지에 다음과 유사한 <Query>로 응답합니다.

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

<Transaction> 만들기

그런 다음 다음 숙박에 대한 호텔 가격 업데이트가 포함된 <Transaction>를 만들어야 합니다.

5/20/23 - 5/23/23

체크인 기간 요청 및 응답 흐름

힌트 응답 메시지는 첫 번째 체크인 날짜부터 마지막 체크인 날짜까지의 체크인 날짜 범위를 지정할 수 있습니다. Google에서 새 가격 데이터를 가져오면 Google은 해당 날짜부터 지정한 숙박 기간까지 호텔의 모든 체크인 날짜에 대한 숙박 일정을 가져옵니다.

파트너의 기간 날짜

다음 힌트 응답 메시지 예에서는 체크인 기간이 있는 단일 숙박 시설을 정의합니다.

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

Google의 응답

Google은 다음과 유사한 <Query>로 이 힌트 응답 메시지에 응답합니다.

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

<Transaction> 만들기

그런 다음 해당 호텔의 다음 숙박에 대한 가격 업데이트가 포함된 <Transaction>를 만들어야 합니다.

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

이 예에서는 숙박 일수를 5박으로 사용합니다. 기본 숙박 기간은 30일입니다.

기간별 숙박 요청 및 응답 흐름

힌트 응답 메시지에는 변경된 기간이 포함될 수 있습니다. 이렇게 하면 Google에 이러한 날짜의 영향을 받는 모든 숙박 일정을 가져와야 한다고 알립니다. 가져온 실제 숙박 일정 집합은 변경된 날짜 집합과 최대 숙박 기간의 함수입니다.

파트너의 숙박 기간 범위

다음 힌트 응답 메시지 예시에서는 숙박 기간 범위를 사용합니다.

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

Google의 응답

Google은 힌트 응답 메시지에 다음과 유사한 <Query>로 응답합니다.

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

<Transaction> 만들기

그런 다음 다음 숙박에 대한 호텔 가격 업데이트가 포함된 <Transaction>를 만들어야 합니다.

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