힌트 응답 메시지

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에서 새로운 가격 데이터를 가져오면 해당 날짜부터 시작하여 사용자가 지정한 숙박 기간까지 호텔의 모든 체크인 날짜에 해당하는 숙박 일정을 가져옵니다.

파트너의 기간 지정 날짜

다음 힌트 응답 메시지 예는 체크인 날짜 범위의 단일 속성을 정의합니다.

<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박을 사용합니다.

Ranged Stay 요청 및 응답 흐름

힌트 응답 메시지에는 변경된 날짜 범위가 포함될 수 있습니다. 이렇게 하면 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