힌트 응답 메시지

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박입니다. 기본 숙박 기간은 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