쿼리 메시지는 Google의 가격 책정 또는 메타데이터 업데이트 요청입니다. 그들은 가져오기 및 변동된 가격 모두에 사용됩니다. 전송 모드.
쿼리 메시지의 루트 요소는 <Query>
입니다.
쿼리 메시지의 구조는 메시지 유형에 따라 다릅니다.
가격: Google에서 지정된 호텔의 가격 업데이트를 요청하는 쿼리 메시지를 전송합니다.
메타데이터: Google은 지정된 호텔의 객실 및 패키지 정보에 관한 데이터를 요청하는 쿼리 메시지를 전송합니다.
Google에서 쿼리 메시지 및 라이브 스트리밍에 사용하는 엔드포인트 정의 초기 구성 중 가격 책정 쿼리 자세한 내용은 기술계정 관리자 (TAM)에게 문의하세요.
Google은 Content-Type
헤더를 'application/xml'로, User-Agent
헤더를 Google-HotelAdsPrices
로 설정하여 쿼리 메시지를 HTTP POST
요청으로 전송합니다. 이 규칙의 예외는 Google-TravelAds-Live
를 통한 가격 엔드포인트 통합을 수동으로 테스트하는 동안 발생합니다. 이러한 샘플은
쿼리에는 User-Agent
헤더가 포함될 수도 있고 포함되지 않을 수도 있습니다.
쿼리 메시지의 자세한 형식은 쿼리 XML 참조.
가격 쿼리 메시지
가격 쿼리 메시지는 어떤 숙박 시설 및 여행 일정 조합을 지정할지 게시자가 가격을 제공할 수 있습니다.
서버가 가격 책정 쿼리 메시지를 수신하면 요청된 가격 정보가 포함된 <Transaction>
메시지로 응답해야 합니다.
자세한 내용은 가격 책정 개요를 참고하세요.
쿼리 메시지에는 세 가지 특수한 유형이 있습니다.
실시간 가격: 사용 설정하면 사용자가 활성 상태일 때 쿼리가 전송됩니다. 내가 지정한 숙박 시설이나 여행 일정 조합의 가격을 응답 기한을 정합니다.
컨텍스트 사용: 사용 설정하면 Google에서 호텔에 전송하는 각 검색어에 사용자 컨텍스트 추천이 포함되며, 추천은 특정 숙박 시설 또는 숙박 시설 + 경로 조합을 검색하는 가장 일반적인 사용자 유형을 반영합니다. 이러한 권장사항을 따르면 업무의 효율성을 확인할 수 있습니다
메타데이터: 호텔측 객실 및 패키지 관련 세부정보 요청입니다. 지정할 수 있습니다.
실시간 가격 쿼리
실시간 가격 쿼리는 사용자 검색에 대한 응답입니다. Google에서 사용자의 호텔 또는 숙박 시설/여행 일정 조합 검색 요청을 수신했지만 가격 데이터를 사용할 수 없거나 최신 가격이 아니므로 Google에서는 검색 시점에 가격 업데이트를 요청합니다. 실시간 가격 쿼리를 사용하면 Google에서 검색 시 가격을 가져와 결과에 표시하려고 시도합니다.
모든 실시간 가격 쿼리 요청에는 일반적으로 최대 4000밀리초입니다. 이 한도는 실시간 가격 쿼리 요청에 지정됩니다. 제한 시간 내에 응답을 제공하지 못하면 특정 기회에 대한 미참여 입찰 발생 하지만 가격을 캐시하고 향후 기회에 사용할 수 있도록 가격을 제공하는 것이 좋습니다. 응답의 연결은 10분 동안 또는 모든 필수 정보가 포함되어 있습니다.
실시간 가격 쿼리도 컨텍스트에 따라 달라지며 사용자 국가, 기기 유형, 숙박 인원(투숙객 수), 투숙객이 성인인지 어린이인지에 관한 매개변수의 가격을 검색할 수 있습니다. 실시간 가격 쿼리를 사용하면 고객이 검색한 내용과 일치하는 최신 가격을 더 많이 표시할 수 있습니다.
실시간 가격 쿼리는 가격 책정을 위한 보조 메커니즘이 되어야 합니다. 업데이트. 가격 재조정의 기본 메커니즘은 여전히 가져오기 또는 변경입니다. 살펴봤습니다 실시간 가격 쿼리는 Google이 제공할 수 없는 격차를 메우는 데 도움이 됩니다. 호텔 또는 숙박 일정 조합의 가격입니다.
실시간 가격 책정 쿼리 사용 규칙
요청된 일정이 비정상적(예: 날짜가 먼 미래이거나 호텔 검색 빈도가 매우 낮음)이므로 지정된 일정에 대한 캐시된 데이터가 없습니다.
요청한 날짜가 기본 날짜가 아닙니다.
: 참고: 기본 날짜는 실시간 가격 쿼리에 사용할 수 없습니다. 게시 중 가격 쿼리는 기본 날짜가 아닌 날짜에 대해서만 요청됩니다.
Google은 일반적으로 동일한 호텔 또는 숙박 일정이 다시 쿼리되지 않도록 실시간 가격의 결과를 캐시합니다. 단일 호텔 또는 숙박 일정 조합과 다중 호텔 또는 단일 숙박 일정 조합을 모두 요청할 수 있습니다.
컨텍스트를 사용한 실시간 가격 책정 기능을 사용하면 Google에서
사용자의 기기 유형(출발 국가)을 기반으로 실시간 가격 요청
어린이를 포함한 숙박 인원이 표시됩니다. 쿼리 메시지와 거래 메시지 모두 쿼리 매개변수를 정의하는 <Context>
요소를 포함하도록 확장됩니다. 가격 정보 제공:
컨텍스트가 포함된 실시간 가격 쿼리를 Room Bundle로 캐시할 수 있습니다.
특정 숙박 인원에 대한 가격 및 조건부 요금인 경우
사용자 국가 또는 사용자 기기의 경우
컨텍스트 쿼리 사용
컨텍스트 쿼리는 지정된 속성 또는 숙박 일정 조합입니다. 여기에는 사용자 목록이 포함되어 있습니다. 인기 있는 컨텍스트가 표시됩니다. 만약 이후부터는 조건부 요금이 사용됩니다. 가능한 모든 사용자 컨텍스트에 대한 전송 속도는 비용이 많이 들 수 있으므로 이 사용자 컨텍스트 목록을 사용하여 응답을 제한하세요. 지정된 사용자 상황의 가격만 반환하면 관련성 높은 사용자 검색어의 대부분을 처리할 수 있습니다.
'문맥 타겟팅' 관련 검색어를 받고 싶다면 기술 계정 관리자 (TAM) 그들은 귀하가 이러한 정보를 받을 준비가 되었음을 확인해 줄 수 있습니다. 구성을 조정하여 사용자 컨텍스트 전송을 얻게 될 것입니다.
메타데이터 쿼리 메시지
메타데이터 쿼리 메시지에는 지정된 숙박 시설의 객실 및 패키지 정보에 관한 세부정보가 포함됩니다.
metadata 쿼리 메시지를 받으면
요청된 숙박 시설의 가격을 지정하는 <Transaction>
메시지
(<Result>
요소에서)
자세한 내용은 방 및 패키지 메타데이터 정의를 참고하세요.
제어 쿼리
이 섹션에서는 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>
이 예에서는 단일 호텔의 가격을 요청합니다.
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 및 패키지 메타데이터 정의