힌트 응답 메시지

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