이 페이지는 Cloud Translation API를 통해 번역되었습니다.

쿼리 및 힌트 XML 참조

이 섹션에서는 Google XML 기반 힌트 요청 메시지, 힌트 응답 메시지, 질의 메시지에 대한 참조를 제공합니다.

`<Hint>` (힌트 응답 메시지)

힌트 응답 메시지의 루트 요소입니다. 힌트 응답 메시지는 가격을 다시 매겨야 하는 호텔 또는 숙박 일정 조합을 지정합니다. 이는 Google의 힌트 요청 메시지에 대한 대답입니다.

힌트 응답 메시지는 Google이 서버로부터 마지막으로 성공적인 힌트 응답을 수신한 이후 가격이 변경된 호텔만 지정해야 합니다.

힌트 응답 메시지는 다음 방법 중 하나를 사용하여 Google에서 가격을 다시 매겨야 하는 호텔과 여정을 지정합니다.

정확한 일정: 체크인 날짜와 숙박 기간의 조합입니다.
체크인 날짜 범위: 첫 번째 체크인 날짜로 시작하고 마지막 체크인 날짜로 끝나는 체크인 날짜 범위를 지정합니다.
범위 지정 숙박 (또는 범위 지정 일정)

이러한 각 메서드에는 힌트 응답 메시지에 다른 구문이 필요합니다.

자세한 내용은 힌트 응답 메시지를 참고하세요.

구문

<Hint> 요소는 힌트 응답 메시지 유형에 따라 다른 문법을 사용합니다.

정확한 일정

다음은 힌트 응답 메시지의 정확한 여정의 구문을 보여줍니다.

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>hotel_ID</Property>
    ...
    <Stay>
      <CheckInDate>checkin_date</CheckInDate>
      <LengthOfStay>number_of_nights</LengthOfStay>
    </Stay>
  </Item>
  ...
</Hint>

체크인 범위

다음은 힌트 응답 메시지의 체크인 범위 구문을 보여줍니다.

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <Property>hotel_ID</Property>
    [...]

    <!-- Required -->
    <FirstDate>first_checkin_date</FirstDate>
    <!-- Required -->
    <LastDate>last_checkin_date</LastDate>
  </Item>
  ...
</Hint>

범위 지정 숙박

다음은 힌트 응답 메시지에서 범위 지정된 유지의 구문을 보여줍니다.

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <!-- At least one is required -->
    <Property>1458700</Property>
    <Property>5418701</Property>
    <StaysIncludingRange>
      <!-- Required -->
      <FirstDate>2025-04-28</FirstDate>
      <!-- Optional -->
      <LastDate>2025-04-29</LastDate>
    </StaysIncludingRange>
  </Item>
  ...
</Hint>

속성

<Hint> 요소에는 선택적 속성인 id가 포함됩니다. 제공된 경우 이 <Hint>를 기반으로 전송된 <Query> 메시지에 hintId 속성으로 포함됩니다.

하위 요소

<Hint> 요소에는 다음과 같은 하위 요소가 있습니다.

하위 요소	필수 여부	유형	힌트 응답 유형	설명
<CheckInDate>	Required	Date	정확한 일정	숙박 일정의 체크인 날짜입니다.
<FirstDate>	Required	Date	체크인 범위 및 범위가 지정된 여행 일정	체크인 범위 또는 범위 지정 숙박 힌트 응답 메시지의 기간 중 첫 번째 날짜입니다. 날짜는 포함됩니다.
<Item>	Required	Object	전체	업데이트할 호텔/숙박 일정의 컨테이너입니다.
<LastDate>	Required*	Date	체크인 범위 및 범위가 지정된 여행 일정	체크인 범위 또는 범위 지정 숙박 힌트 응답 메시지의 기간 마지막 날짜입니다. 날짜는 포함됩니다. * 이 요소는 숙박 기간이 있는 경우 선택사항입니다.
<LengthOfStay>	Required	integer	정확한 일정	숙박 일정의 기간(일수)입니다. 양의 정수로 표현됩니다.
<Property>	Required	string	전체	호텔 목록과 동일한 ID를 사용하는 호텔의 ID입니다. 단일 `<Item>` 블록에서 지정할 수 있는 `<Property>` 요소의 수는 힌트 응답 메시지의 유형에 따라 결정됩니다. 정확한 숙박 일정: 최대 100개의 호텔 체크인 범위: `<QueryControl>` 메시지에서 `<MultipleItineraries>`을 `"checkin_range"`로 설정한 경우 두 개 이상 범위 내 체류: `<QueryControl>` 메시지에서 `<MultipleItineraries>`을 `"affected_dates"`로 설정한 경우 1보다 큼
<Stay>	Required	Object	정확한 일정	정확한 여정 힌트 응답 메시지의 `<CheckinDate>` 및 `<LengthOfStay>` 요소의 컨테이너입니다. 각 `<Item>`에는 단일 `<Stay>`만 포함될 수 있습니다.
<StaysIncludingRange>	Required	Object	범위가 지정된 여행 일정	범위 지정 숙박 힌트 응답 메시지에 있는 `<FirstDate>` 및 `<LastDate>` 요소의 컨테이너입니다.

예

정확한 일정

다음 예에서는 단일 숙박 시설에 대한 여러 여정을 정의합니다. 힌트 응답 메시지:

<!-- Exact Itinerary Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2018-07-03</CheckInDate>
      <LengthOfStay>4</LengthOfStay>
    </Stay>
  </Item>
</Hint>

체크인 범위

다음 예시에서는 가격이 변경되어 다시 가져와야 하는 호텔 두 곳을 지정합니다. Google은 속성 12345 및 67890에 대해 7월 3일과 7월 6일 사이의 모든 여정을 가져옵니다.

<!-- Check-in Ranges Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <Item>
    <Property>12345</Property>
    <Property>67890</Property>
    <FirstDate>2018-07-03</FirstDate>
    <LastDate>2018-07-06</LastDate>
  </Item>
</Hint>

범위 지정 숙박

다음 예에서는 범위가 지정된 숙박의 두 가지 다른 용도를 보여줍니다. 하나는 밤 범위이고 다른 하나는 단일 밤입니다.

<!-- Ranged Stay Hint Response -->
<?xml version="1.0" encoding="UTF-8"?>
<Hint>
  <!-- Google fetches prices for all itineraries (first and last date are set) -->
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
      <LastDate>2018-07-06</LastDate>
    </StaysIncludingRange>
  </Item>

  <!-- Google fetches prices for a single night (first date only) -->
  <Item>
    <Property>67890</Property>
    <StaysIncludingRange>
      <FirstDate>2018-07-03</FirstDate>
    </StaysIncludingRange>
  </Item>
</Hint>

이러한 각 예시에서 Google은 <Query>로 응답하며, 지정된 호텔/일정의 가격 업데이트가 포함된 <Transaction>로 응답해야 합니다.

`<HintRequest>`

힌트 요청 메시지의 루트 요소입니다. Google은 서버에 힌트 요청 메시지를 전송하고, 서버에서 마지막으로 성공적인 힌트 응답을 수신한 이후 가격이 변경된 호텔과 여행 일정을 지정하는 응답을 기대합니다.

가격이 변경되면 Google은 표시된 호텔 및 여행 일정의 업데이트된 가격 데이터를 가져오는 <Query>를 전송합니다.

자세한 내용은 힌트 요청 메시지를 참고하세요.

구문

<HintRequest> 요소는 다음 구문을 사용합니다.

구문

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest>
  <LastFetchTime>last_fetch_time</LastFetchTime>
</HintRequest>

속성

<HintRequest> 요소에 속성이 없습니다.

하위 요소

<HintRequest> 요소에는 다음과 같은 하위 요소가 있습니다.

하위 요소	유형	설명
<LastFetchTime>	DateTime	Google이 힌트 요청 메시지에 대한 힌트 응답 메시지를 가져오는 데 성공한 마지막 시간입니다. 이 시간이 서버에서 가격을 마지막으로 업데이트한 시간보다 오래된 경우 변경된 호텔을 지정하는 힌트 응답 메시지로 응답해야 합니다. 최근에 성공적으로 가져온 적이 없는 경우 더 심각한 백로그 문제가 발생하지 않도록 고정된 간격 값으로 설정됩니다. 현재 고정 간격 값은 1, 000초이지만 변경될 수 있습니다. 자세한 내용은 힌트 응답 메시지를 참고하세요.

하위 요소

유형

설명

DateTime

Google이 힌트 요청 메시지에 대한 힌트 응답 메시지를 가져오는 데 성공한 마지막 시간입니다.

이 시간이 서버에서 가격을 마지막으로 업데이트한 시간보다 오래된 경우 변경된 호텔을 지정하는 힌트 응답 메시지로 응답해야 합니다.

최근에 성공적으로 가져온 적이 없는 경우 더 심각한 백로그 문제가 발생하지 않도록 고정된 간격 값으로 설정됩니다. 현재 고정 간격 값은 1, 000초이지만 변경될 수 있습니다.

자세한 내용은 힌트 응답 메시지를 참고하세요.

예

다음 예는 힌트 요청 메시지를 보여줍니다.

힌트 요청 메시지

다음 예시는 힌트 요청 메시지를 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<HintRequest id="ABCDEF" timestamp="2018-06-07T16:20:00Z">
  <LastFetchTime>2018-03-25T00:04:09Z</LastFetchTime>
</HintRequest>

`<Query>`

Query 메시지의 루트 요소입니다. Query 메시지는 Google에서 가격 또는 메타데이터 업데이트를 요청하는 메시지입니다. 이러한 메시지는 풀 및 변동된 요금 게재 모드와 함께 사용됩니다.

가격 쿼리 메시지

가격 쿼리 메시지는 가격을 제공하는 숙박 시설 및 여행 일정 조합을 지정합니다.

서버가 pricing 쿼리 메시지를 수신하면 요청된 가격 정보가 포함된 <Transaction> 메시지로 응답해야 합니다.

자세한 내용은 가격 개요를 참고하세요.

Query 메시지에는 세 가지 특별한 유형이 있습니다.

실시간 요금: Google이 특정 사용자 요청에 응답하여 실시간 요금 업데이트를 요청합니다. 파트너가 Live pricing query 메시지를 수신하면 요청된 가격 정보가 <Result> 요소에 포함된 <Transaction> 메시지로 응답해야 합니다.

핵심 사항: 새 검색 환경으로 인해 EEA 사용자의 경우 실시간 질문의 사용 가능 여부가 제한됩니다.
컨텍스트 가격 책정: Google은 이전부터 인기가 있었던 컨텍스트를 기반으로 가격 캐시를 업데이트합니다. With Context query 메시지를 수신하면 요청된 가격 정보가 <Result> 요소에 포함된 <Transaction> 메시지로 응답해야 합니다.
- 1인 숙박의 컨텍스트 쿼리
  
  컨텍스트가 있는 질문에 대한 응답으로 요금을 제공할 때는 지정된 컨텍스트에 해당하는 요금만 전송해야 합니다. 기본 요금 숙박에는 최소 2명의 숙박객이 필요하므로 기본 요금에 단일 숙박객이 전달되면 무시되고 여전히 2인 숙박으로 처리됩니다. 이 경우 기본 요금을 사용할 수 없음으로 전달하고 1인실 내에 중첩된 요금을 사용해야 합니다. 컨텍스트가 포함된 응답 예시를 참고하세요. 컨텍스트와 함께 변경된 가격을 사용하여 mergeable 속성을 "true"로 설정하여 요금을 병합할 수 있습니다. 자세히 알아보기
- 컨텍스트를 사용한 변동된 가격 (구 Pull with Hints)
  
  <Transaction> 메시지 응답을 Changed Pricing with Context 쿼리에 전송하면 Google에서는 이를 특정 호텔 또는 여정의 가격 및 예약 가능 여부 정보의 전체 대체로 취급하며, 모든 컨텍스트별 요금이 응답에서 제외되고 캐시에서 삭제됩니다.
  
  덮어쓰기를 방지하려면 <Transaction> 메시지의 <Result> 요소 내에서 mergeable 속성을 "true"로 설정해야 합니다. Google은 응답에서 제공된 컨텍스트의 기존 캐시된 요율을 요율에 추가합니다. 병합 가능한 속성을 사용하지 않는 경우 응답에서 적용 가능한 모든 컨텍스트의 요금을 모두 전송해야 합니다.
- 컨텍스트를 사용한 실시간 가격 쿼리
  
  컨텍스트가 있는 실시간 가격 쿼리는 기본적으로 병합 가능한 속성 동작을 가지므로 이 속성을 설정하지 않아도 됩니다. 다른 모든 컨텍스트가 동일하게 유지되는 경우 Google에서 요청한 특정 컨텍스트의 요율만 전송하면 됩니다. 다른 컨텍스트가 변경된 경우 해당 컨텍스트의 변경사항을 명시적으로 전송해야 합니다. 그렇지 않으면 Google 캐시에서 새 요율이 업데이트되지 않습니다.
  
  핵심사항: 컨텍스트를 사용한 변경된 가격은 기본적으로 덮어쓰고 컨텍스트를 사용한 실시간 가격 쿼리는 기본적으로 병합됩니다.
메타데이터: Google은 지정된 호텔의 객실 및 객실 번들에 대한 메타데이터 업데이트를 요청합니다. Metadata Query 메시지를 수신하면 <PropertyDataSet> 요소의 객실 및 객실 패키지에 관한 데이터를 지정하는 <Transaction> 메시지로 응답해야 합니다. 자세한 내용은 Room Bundle 메타데이터를 참고하세요.

구문

<Query> 요소는 다음 구문을 사용합니다.

가격 쿼리

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <PropertyList>
    <Property>hotel_id</Property>
    ...
  </PropertyList>
</Query>

실시간 가격

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyList>
    <Property>hotel_id</Property>
    ...
  </PropertyList>
  <!-- See documentation below for <Context> -->
  <Context>
   ...
  </Context>
</Query>

컨텍스트 쿼리 사용

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>YYYY-MM-DD</Checkin>
  <Nights>number_of_nights</Nights>
  <!-- Only for Check-in Date Range pricing queries (Changed Pricing) -->
  <FirstDate>YYYY-MM-DD</FirstDate>
  <LastDate>YYYY-MM-DD</LastDate>
  <!-- Only for Ranged Stay pricing queries (Changed Pricing) -->
  <AffectedNights>number_of_nights</AffectedNights>
  <PropertyContextList>
    <PropertyContext>
      <Property>hotel_id</Property>
      ...
      <!-- See documentation below for <Context> -->
      <Context>
      ...
      </Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

메타데이터

<HotelInfoProperties>
  <Property>property_ID</Property>
  ...
</HotelInfoProperties>

속성

<Query> 요소는 latencySensitive 속성을 하나 포함할 수 있습니다.

latencySensitive 속성은 선택사항입니다. 제공되고 true로 설정되면 쿼리가 Live Pricing Query임을 나타냅니다. Google에서 latencySensitive 속성으로 쿼리를 전송하도록 하려면 기술계정 관리자 (TAM)에게 문의하세요.

하위 요소

<Query> 요소에는 다음과 같은 하위 요소가 있습니다.

하위 요소	질문 유형	유형	설명
<AffectedNights>	Pricing	integer	범위가 지정된 숙박의 기간(일수)입니다. 이 요소는 변경된 가격과 함께 사용되는 범위 숙박 가격 책정 쿼리에만 사용됩니다.
<Checkin>	Pricing	Date	특정 가격 변경의 날짜입니다.
<Context>	Pricing (Live Pricing Queries only)	<Context>	실시간 가격 쿼리의 경우 쿼리가 이루어지는 특정 매개변수를 지정합니다. 하위 요소는 다음과 같습니다. `<Occupancy>`: 총 게스트 수 `<OccupancyDetails>`: 게스트 유형(예: 성인 또는 어린이) `<UserCountry>`: 사용자가 있는 국가 `<UserDevice>`: 게스트가 호텔을 검색하는 데 사용한 기기 유형입니다(예: `"mobile`, `tablet`, `desktop`). `<Context>` 요소는 단일 요청에서 반복될 수 있으므로 다양한 점유율에 대한 쿼리가 허용됩니다. 하위 요소, 구문, 예시 목록은 `<Context>`을 참고하세요.
<FirstDate>	Pricing	Date	가격이 적용되는 여행 일정 범위의 시작일입니다. 이 요소는 변경된 가격과 함께 사용되는 체크인 날짜 범위 가격 책정 쿼리에만 사용됩니다.
<HotelInfoProperties>	Metadata	string	Google에서 메타데이터 `Query` 메시지에서 업데이트된 룸 및 룸 번들 메타데이터를 원하는 하나 이상의 속성입니다. 이 요소에는 호텔 숙박 시설 ID를 지정하는 하나 이상의 `<Property>` 요소가 포함될 수 있습니다.
<LastDate>	Pricing	Date	가격이 적용되는 여행 일정 범위의 종료일입니다. 이 요소는 가져오기 + 힌트와 함께 사용되는 체크인 날짜 범위 가격 책정 쿼리에만 사용됩니다.
<Nights>	Pricing	integer	특정 숙박 일정의 숙박 일수입니다(최대 30일).
<PropertyList>	Pricing	Object	가격 업데이트가 필요한 호텔의 ID가 하나 이상입니다. `<Property>` 요소에 각 호텔을 정의합니다. 값은 호텔 목록의 호텔 ID와 일치하는 문자열입니다. 예: <PropertyList> <Property>pid1</Property> <Property>pid2</Property> </PropertyList>

예

가격 책정 쿼리

다음 예시는 2023년 5월 23일부터 시작하여 3박 동안 이용 가능한 호텔 세트의 가격 업데이트를 요청하는 가격 책정 쿼리 메시지를 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </PropertyList>
</Query>

실시간 가격 쿼리

다음 예시는 응답 시간 제한이 500밀리초인 실시간 가격 쿼리를 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="8"/>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

컨텍스트 쿼리 사용

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, device might be specified -->
      <Context><UserCountry>US</UserCountry></Context>
      <Context><UserCountry>GB</UserCountry></Context>
    </PropertyContext>
    <PropertyContext>
      <Property>8675310</Property>
      <Property>8675311</Property>
      <Context><UserCountry>CA</UserCountry></Context>
    </PropertyContext>
  </PropertyContextList>
</Query>

컨텍스트 응답

다음 예에서는 1인 숙박의 기본 요금을 unavailable(-1)로 설정하고 요금을 <Occupancy> 요소에 중첩하는 방법을 설명합니다.

<?xml version="1.0" encoding="UTF-8"
<Transaction id="Wtdj8QoQIWcAAbaTGlIAAAC4" timestamp="2025-11-19T18:36:48Z">
<Result>
  <Property>6781291</Property>
  <Checkin>2026-01-15</Checkin>
  <Nights>1</Nights>
  <!-- Base rate is set to -1 to indicate unavailability for the default (2-person) occupancy -->
  <Baserate currency="USD">-1</Baserate>
  <Tax currency="USD">0</Tax>
  <OtherFees currency="USD">0</OtherFees>
  <Rates>
    <!-- Nested Rate for Single Occupancy -->
    <Rate rate_rule_id="rule-951">
      <Occupancy>1</Occupancy>
      <OccupancyDetails>
        <NumAdults>1</NumAdults>
      </OccupancyDetails>
      <Baserate currency="USD">150.00</Baserate>
      <Tax currency="USD">15.00</Tax>
      <OtherFees currency="USD">5.00</OtherFees>
    </Rate>
  <!-- Other nested rates for different occupancies or room types could be included here if available -->
  </Rates>
</Result>
</Transaction>

메타데이터 쿼리

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <HotelInfoProperties>
    <Property>pid5</Property>
    <Property>pid8</Property>
    <Property>pid13</Property>
    <Property>pid21</Property>
  </HotelInfoProperties>
</Query>

숙박 기간 및 체크인 날짜 범위 가격 쿼리를 비롯한 추가 예시는 Query 메시지 예시를 참고하세요.

`<Context>`

<Context> 요소는 게스트 수와 유형, 사용자 국가, 사용자 기기 등 Live pricing query에 관한 정보를 설명합니다.

여러 <Context>가 서로 다른 사용자 국가 또는 사용자 기기와 함께 사용되는 경우는 없습니다. 여러 <Context>를 사용하여 여러 숙박을 쿼리하는 경우 각 숙박 가격을 해당 숙박 시설 또는 일정의 추가 객실 번들로 제공합니다. 각 숙박 시설 또는 일정에는 여러 숙박 인원의 가격이 포함된 단일 <Result> 블록이 있어야 합니다.

<Context> 쿼리의 응답 세부정보는 <OccupancyDetails>를 참고하세요.

구문

<Context> 요소는 다음 구문을 사용합니다.

구문

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true_or_false">
  <Checkin>date</Checkin>
  <Nights>number_of_nights</Nights>
  <DeadlineMs>number_of_milliseconds</DeadlineMs>
  <PropertyList>
    <Property>property_ID</Property>
  </PropertyList>
  <Context>
    <Occupancy>total_number_of_guests</Occupancy>
    <OccupancyDetails>
      <NumAdults>number_of_adults</NumAdults>
      <Children>
        <Child age=age_of_one_child_guest/>
        <Child age=age_of_one_child_guest/>
      </Children>
    </OccupancyDetails>
    <UserCountry>end_user_country</UserCountry>
    <UserDevice>user_device_type</UserDevice>
  </Context>
</Query>

하위 요소

<Context> 요소에는 다음과 같은 하위 요소가 있습니다.

하위 요소	쿼리 유형	유형	설명
<Occupancy>	Pricing	integer	총 게스트 수를 지정합니다. 필수는 아니지만 `<Occupancy>`가 포함된 쿼리는 각 `<Occupancy>`에 대해 정의된 적절한 객실 패키지가 포함된 트랜잭션 메시지를 생성해야 합니다. 객실 패키지를 사용할 수 없는 경우 `<Occupancy>` 요소를 지정하는 것이 좋습니다. 참고:`<Occupancy>`는 쿼리에 항상 표시되지 않을 수 있습니다. 이러한 경우 모든 점유율의 가격을 반환해야 합니다.
<OccupancyDetails>	Pricing	Object	`<Occupancy>`이 앞에 옵니다. 다음과 같은 유형별 게스트를 지정합니다. `<NumAdults>`: 성인 게스트 수 `<Children>` 및 `<Child="age">`: 어떤 게스트가 아동 (일반적으로 만 0~17세)인지 지정하고, 선택적으로 각 아동의 연령을 포함합니다. 필수는 아니지만 `<OccupancyDetails>`이 포함된 쿼리는 각 `<Occupancy>`에 대해 정의된 적절한 객실 패키지가 포함된 트랜잭션 메시지를 생성해야 합니다. 객실 패키지를 사용할 수 없는 경우 `<OccupancyDetails>` 요소를 지정하는 것이 좋습니다. 참고: `<OccupancyDetails>`는 쿼리에 항상 표시되지 않을 수 있습니다. 이러한 경우 모든 게스트가 성인이라고 가정해야 합니다.
<UserCountry>	Pricing	string	사용자가 위치한 국가별로 요금을 필터링합니다. 값은 2자리 국가 코드(예: 미국의 경우 `"US"`) 또는 지역 코드(예: '유럽'의 경우 `"EU"`)입니다. `<UserCountry>`가 정의된 쿼리는 쿼리된 국가에 대해 적절한 `<Rates>` 블록이 정의된 트랜잭션 메시지를 생성해야 합니다.
<UserDevice>	Pricing	string	사용자가 검색하는 기기 유형별로 요금을 필터링합니다. 가능한 값은 다음과 같습니다. `mobile` `desktop` `tablet` `<UserDevice>`가 정의된 쿼리는 쿼리된 기기 유형에 대해 정의된 적절한 `<Rates>` 블록이 있는 트랜잭션 메시지를 생성해야 합니다.

예

숙박 인원

다음 예는 <Context> 내에서 <Occupancy>의 실시간 가격 쿼리를 보여줍니다. 실시간 가격 쿼리는 성인 게스트 3명을 위한 것입니다.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

점유 세부정보

다음 예는 <Context> 내에 <OccupancyDetails>가 있는 실시간 가격 쿼리를 보여줍니다. 실시간 가격 쿼리는 4명의 게스트(그중 2명은 어린이)를 대상으로 하며, 휴대기기에서 미국 게스트 예약에 적용되는 요금을 찾습니다.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>5</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>8675309</Property>
  </PropertyList>
  <Context>
    <Occupancy>4</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
      <Children>
        <Child age="4"/>
        <Child age="12"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

여러 컨텍스트

다음 예시에서는 실시간 가격 책정 쿼리에서 추가 <Context> 요소의 사용을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
  <Checkin>2017-06-07</Checkin>
  <Nights>4</Nights>
  <DeadlineMs>500</DeadlineMs>
  <PropertyList>
    <Property>45617</Property>
  </PropertyList>
  <Context>
    <Occupancy>3</Occupancy>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
  <Context>
    <Occupancy>6</Occupancy>
    <OccupancyDetails>
      <NumAdults>4</NumAdults>
      <Children>
        <Child age="6"/>
        <Child age="10"/>
      </Children>
    </OccupancyDetails>
    <UserCountry>US</UserCountry>
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

쿼리 및 힌트 XML 참조 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

<Hint> (힌트 응답 메시지)

구문

정확한 일정

체크인 범위

범위 지정 숙박

속성

하위 요소

예

정확한 일정

체크인 범위

범위 지정 숙박

<HintRequest>

구문

구문

속성

하위 요소

예

힌트 요청 메시지

<Query>

가격 쿼리 메시지

1인 숙박의 컨텍스트 쿼리

컨텍스트를 사용한 변동된 가격 (구 Pull with Hints)

컨텍스트를 사용한 실시간 가격 쿼리

구문

가격 쿼리

실시간 가격

컨텍스트 쿼리 사용

메타데이터

속성

하위 요소

예

가격 책정 쿼리

실시간 가격 쿼리

컨텍스트 쿼리 사용

컨텍스트 응답

메타데이터 쿼리

<Context>

구문

구문

하위 요소

예

숙박 인원

점유 세부정보

여러 컨텍스트

쿼리 및 힌트 XML 참조

`<Hint>` (힌트 응답 메시지)

`<HintRequest>`

`<Query>`

`<Context>`