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

메시지 쿼리

쿼리 메시지는 Google의 가격 책정 또는 메타데이터 업데이트 요청입니다. 그들은 가져오기 및 변동된 가격 모두에 사용됩니다. 게재 모드.

쿼리 메시지의 루트 요소는 <Query>입니다.

쿼리 메시지의 구조는 메시지 유형에 따라 다릅니다.

가격 책정: Google은 지정된 호텔을 검색합니다.
메타데이터: Google에서 회의실에 관한 데이터를 요청하는 쿼리 메시지를 전송합니다. 패키지 정보가 포함되어 있습니다.

Google에서 쿼리 메시지 및 라이브 스트리밍에 사용하는 엔드포인트 정의 초기 구성 중 가격 책정 쿼리 자세한 내용은 기술계정 관리자 (TAM)에게 문의하세요.

Google은 Content-Type를 사용하여 쿼리 메시지를 HTTP POST 요청으로 전송합니다. 헤더가 'application/xml'로 설정됨 그리고 User-Agent 헤더가 Google-HotelAdsPrices입니다. 이 규칙은 Google-TravelAds-Live를 통한 가격 엔드포인트 통합. 이러한 샘플은 쿼리에는 User-Agent 헤더가 포함될 수도 있고 포함되지 않을 수도 있습니다.

쿼리 메시지의 자세한 형식은 쿼리 XML 참조.

가격 책정 쿼리 메시지

가격 책정 쿼리 메시지는 다음과 같은 숙박 시설 또는 여행 일정 조합을 지정합니다. 게시자가 가격을 제공할 수 있습니다.

서버가 가격 쿼리 메시지를 수신하면 요청된 가격 정보가 포함된 <Transaction> 메시지

자세한 내용은 가격 책정 개요를 참조하세요.

쿼리 메시지에는 세 가지 특수한 유형이 있습니다.

실시간 가격: 사용 설정하면 사용자가 활성 상태일 때 쿼리가 전송됩니다. 내가 지정한 숙박 시설이나 여행 일정 조합의 가격을 응답 기한을 정합니다.
컨텍스트 사용: 사용 설정하면 사용자 컨텍스트 추천이 포함됩니다. Google이 보내는 검색어별 검색어 중 특정 숙박 시설 또는 숙박 일정을 검색하는 일반적인 사용자 유형 조합할 수 있습니다. 이러한 권장사항을 따르면 업무의 효율성을 확인할 수 있습니다
메타데이터: 호텔측 객실 및 패키지 관련 세부정보 요청입니다. 지정할 수 있습니다.

실시간 가격 쿼리

실시간 가격 쿼리는 사용자 검색에 대한 응답입니다. Google은 사용자로부터 가격 데이터를 사용할 수 없거나 이용할 수 없는 경우 Google은 검색 시 가격 업데이트를 요청합니다. 다음으로 바꿉니다. 실시간 가격 쿼리를 통해 Google은 가격을 가져와 검색 시점의 결과입니다.

모든 실시간 가격 쿼리 요청에는 일반적으로 최대 4000밀리초입니다. 이 한도는 실시간 가격 책정 쿼리에 지정되어 있습니다. 합니다. 제한 시간 내에 응답을 제공하지 못하면 특정 기회에 대한 미참여 입찰입니다. 하지만 캐시하여 향후 기회를 위해 사용할 수 있도록 가격을 제공합니다. 응답의 연결은 10분 동안 또는 모든 필수 정보가 포함되어 있습니다.

실시간 가격 쿼리도 상황에 따라 다르며 매개변수: 사용자 국가, 기기 유형, 숙박 인원 (손님 수), 투숙객이 성인인지 어린이인지에 관한 정보가 표시됩니다. 실시간 가격 쿼리를 사용하면 고객이 검색한 내용과 일치하는 최신 가격을 더 많이 표시할 수 있습니다.

실시간 가격 쿼리는 가격 책정을 위한 보조 메커니즘이 되어야 합니다. 업데이트. 가격 재조정의 기본 메커니즘은 여전히 가져오기 또는 변경입니다. 살펴봤습니다 실시간 가격 쿼리는 Google이 제공할 수 없는 격차를 메우는 데 도움이 됩니다. 호텔 또는 숙박 일정 조합의 가격입니다.

실시간 가격 책정 쿼리 사용 규칙

요청된 숙박 일정이 있으므로 지정된 여행 일정의 캐시된 데이터가 없습니다. 날짜가 매우 먼 미래이거나 호텔이 매우 멀거나 자주 사용되지 않는 검색어입니다.
요청한 날짜가 기본 날짜가 아닙니다.

: 참고: 실시간 가격 쿼리에는 기본 날짜를 사용할 수 없습니다. 게시 중 가격 쿼리는 기본 날짜가 아닌 날짜에 대해서만 요청됩니다.

Google은 일반적으로 실시간 가격의 결과를 캐시하므로 동일한 호텔이나 호텔이 여정이 다시 쿼리되지 않습니다. 단일 호텔 또는 숙박 일정을 모두 요청할 수 있습니다. 여러 호텔 또는 단일 숙박 일정 조합도 이용할 수 있습니다.

컨텍스트를 사용한 실시간 가격 책정 기능을 사용하면 Google에서 사용자의 기기 유형(출발 국가)을 기반으로 실시간 가격 요청 어린이를 포함한 숙박 인원이 표시됩니다. 그리고 쿼리 메시지와 거래 메시지가 확장되어 쿼리 매개변수를 정의하는 <Context> 요소. 가격 정보 제공: 컨텍스트가 포함된 실시간 가격 쿼리를 Room Bundle로 캐시할 수 있습니다. 특정 숙박 인원에 대한 가격 및 조건부 요금인 경우 사용자 국가 또는 사용자 기기의 경우

컨텍스트 쿼리 사용

컨텍스트 쿼리는 지정된 속성 또는 숙박 일정 조합입니다. 여기에는 사용자 목록이 포함되어 있습니다. 인기 있는 컨텍스트가 표시됩니다. 만약 그런 다음 조건부 요금이 사용됩니다. 가능한 모든 사용자 컨텍스트에 대한 전송 속도는 비용이 많이 들 수 있으므로 이 사용자 컨텍스트 목록을 사용하여 응답을 제한하세요. 반품 가격 지정된 사용자 컨텍스트는 관련 사용자 검색어의 대부분을 포괄합니다.

메타데이터 쿼리 메시지

메타데이터 쿼리 메시지에는 객실 및 패키지 정보에 관한 세부정보가 포함됩니다. (지정된 속성의 경우)

metadata 쿼리 메시지를 받으면 요청된 숙박 시설의 가격을 지정하는 <Transaction> 메시지 (<Result> 요소에서)

자세한 내용은 Room 및 패키지 메타데이터 정의를 참고하세요.

쿼리 제어

이 섹션에서는 숙박 시설과 숙박 일정을 관리하는 방법을 설명합니다. Google이 보내는 쿼리 메시지의 제목이 될 수 있습니다.

여행 일정 경계

쿼리 결과를 바탕으로 가격 책정 쿼리의 가능한 경계를 <ItineraryCapabilities> 날짜 범위를 결정하는 규칙 정의 지원하는 최대 숙박 기간이 포함됩니다

<MaxAdvancePurchase> 및 <MaxLengthOfStay>의 기본값을 설정할 수 있습니다. 모든 호텔 또는 숙박 일정 조합에 적용됩니다. 또한 이러한 설정 등이 있습니다.

쿼리 메시지 예시

이 섹션에서는 쿼리 메시지 및 메타데이터 가격 책정의 몇 가지 예시를 보여줍니다. 쿼리 메시지 추가 예는 다음에서 확인할 수 있습니다. 쿼리 XML 참조.

샘플 여행 일정

다음 예시는 가격 업데이트를 요청하는 가격 <Query>을 보여줍니다. 2023년 5월 23일부터 3박 동안 이용할 수 있는 호텔 4개

<?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>

이 예시에서는 각 호텔의 가격 업데이트를 요청합니다.

5/23/18 - 6/26/18

실시간 가격 쿼리 예시

다음 예시는 응답 시간 제한이 있는 실시간 가격 책정 쿼리를 보여줍니다. 최대 500밀리초의 속도로 이루어집니다.

<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
     be configured to be displayed, on request, by Google. This attribute is only
     displayed for a Live Pricing Query request -->
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
     received by. This element is only displayed for a Live Pricing Query request -->
  <PropertyList>
    <Property>6781291</Property>
  </PropertyList>
<!-- Note that Context tags are potentially repeatable -->
  <Context>
<!-- The total number of guests occupying the room (adults+children) -->
    <Occupancy>3</Occupancy>
    <OccupancyDetails>
      <NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
      <Children>
        <Child age="5"/>
      </Children>
    </OccupancyDetails>
<!-- The user was located in the US when this search was made -->
    <UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
    <UserDevice>mobile</UserDevice>
  </Context>
</Query>

이 예에서는 호텔 1개의 가격을 요청합니다.

6/23/23 - 6/25/23

이 쿼리에 대한 트랜잭션 메시지 응답 샘플은 가격 및 객실 인벤토리 (거래) XML 참조

컨텍스트 쿼리 예

다음 예는 컨텍스트 사용 쿼리의 예를 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<Query>
  <Checkin>2023-05-23</Checkin>
  <Nights>2</Nights>
  <PropertyContextList>
    <PropertyContext>
      <Property>8675309</Property>
      <!-- In the future, occupancy and 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>

컨텍스트 쿼리를 사용하면 사용자 국가 컨텍스트만 지정할 수 있습니다. 향후 이러한 쿼리가 사용자 기기와 숙박 인원을 지정할 수도 있습니다.

체크인 기간

변동된 가격 책정을 사용하는 경우 쿼리 메시지의 구조는 체크인 기간에 사용하는 힌트 유형을 검색하며 운항 일정과 관련이 있습니다. 이러한 각 유형에 대해 자세히 알아보려면 힌트 유형에 대한 내용은 힌트 응답 메시지를 참조하세요.

다음 예는 체크인 날짜에 대한 가격 <Query> 메시지를 보여줍니다. 범위:

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

이 예시에서는 다음 숙박에 대한 가격 업데이트를 요청합니다 (각 숙박에 대한 호텔):

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

원거리 숙박

다음 예시는 범위 지정 가격 책정 <Query> 메시지를 보여줍니다. 유지:

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

이 예시에서는 각 호텔의 가격 업데이트를 요청합니다.

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23

주어진 밤 전에 시작된 (하지만 포함) 숙박 시설입니다.

5/20/23 - 5/23/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

메타데이터 쿼리 메시지

다음 예는 메타데이터를 요청하는 <Query> 메시지를 보여줍니다. 여러 숙박 시설의 객실 업데이트 및 패키지 정보:

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

이러한 유형의 쿼리 메시지에 대한 응답으로, Room 및 패키지 메타데이터를 정의합니다. 자세한 내용은 Room 및 패키지 메타데이터 정의