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

인벤토리 메시지

개요

인벤토리 메시지 (OTA_HotelInvCountNotifRQ)는 특정 방 유형에 예약할 수 있는 인벤토리 수(실제 회의실 수)를 정의합니다. 인벤토리 메시지를 보낼 때는 지정된 날짜에 이용 가능한 해당 유형의 회의실 수를 표시합니다. 해당 유형의 객실이 없으면 해당 객실 유형 및 날짜와 관련된 제품이 표시되지 않습니다.

다음 섹션에서는 인벤토리 추가 및 업데이트와 인벤토리 메시지 전송을 시작할 수 있는 일반 가이드라인, 기본 예시, 방법 시나리오를 설명합니다.

다양한 인벤토리 관련 시나리오의 예는 방법을 참고하세요.

필수 및 선택 요소

XML 참조에서는 필수 및 선택적 요소에 대한 설명을 제공합니다. 속성 및 하위 요소에 관한 자세한 내용은 인벤토리 요소 및 속성을 참고하세요.

구문 및 스키마

인벤토리 메시지를 만들 때 올바른 형식을 따르도록 인벤토리 구문 예를 참조로 사용하세요.

Google에 피드를 제출하기 전에 xmllint와 같은 서드 파티 XML 도구를 사용하여 게시된 스키마로 피드를 검증할 수 있습니다. 인벤토리 메시지 스키마는 호텔 광고 스키마를 참고하세요.

가이드라인

인벤토리 메시지에 다음 가이드라인을 사용하세요.

인벤토리는 호텔, 날짜, 객실 유형에 따라 키가 지정됩니다.
연결된 요금제 및 숙박 인원의 가격을 표시하려면 전체 숙박 일수에 대한 인벤토리 수가 0보다 커야 합니다.
인벤토리 수가 0개와 같으면 지정된 회의실 ID 및 기간에 회의실을 예약할 수 없습니다.
CountType는 '확정 사용 가능 여부'의 수를 나타내므로 항상 2 값이 유효해야 합니다.
시스템에서 객실 예약 또는 취소가 발생할 때마다 업데이트된 인벤토리를 전송합니다.

인벤토리 대 가용성 비교

인벤토리는 실제 개수를 기준으로 한 예약 가능한 객실의 수이며, 예약 가능 여부는 객실 유형과 요금제의 조합을 예약할 수 있는지를 나타냅니다. ARI의 경우 예약 가능 여부 및 인벤토리는 일련의 날짜 또는 숙박 시설 유형에 따라 달라질 수 있으며 둘 다 해당하는 메시지 유형이 있습니다. 재고 및 이용 가능 여부는 호텔, 날짜, 객실 유형에 따라 키가 지정되며 이용 가능 여부를 위한 요금제가 추가됩니다.

인벤토리와 가용성은 서로 독립적이므로 인벤토리가 있는 경우에도 '가용성이 없을 수 있습니다.

가용성에는 두 가지 개념이 있습니다. 첫째, 특정 숙박에 대한 제품의 전반적인 이용 가능 여부가 매일 밤 요금이 정해져 있는지 여부, 관련 객실 유형의 인벤토리, 이용 가능 여부 제한이 미해결 여부 등의 요인에 의해 영향을 받습니다. 둘째, 특정 날짜의 제품에는 구체적인 제한사항이 있으며 이는 OTA_HotelAvailNotifRQ의 <RestrictionStatus Restriction="Master" Status="Open"/>로 표시되며 이 재고를 종료하는 것을 '판매 중단'이라고 합니다.

인벤토리는 객실의 경우 0보다 큰 정수여야 하며 제품 가격을 표시하려면 이용 가능 여부 제한이 열려 있어야 합니다.

예

이 섹션에서는 필수 및 선택적 요소를 사용하는 Inventory 메시지의 기본 예를 제공합니다. 파일이 준비되면 다음 엔드포인트에 POST 메시지를 통해 Google에 파일을 보내야 합니다.

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

메시지를 푸시/POST하는 방법에 관한 자세한 내용은 메시지 푸시를 참조하세요.

HotelCode의 경우 시스템 내에서 속성을 식별하기 위해 사용한 고유한 호텔 ID를 사용합니다. 이 값은 호텔 목록 피드의 <listing> 요소의 <id>를 사용하여 지정된 호텔 ID와 일치해야 합니다. <RoomID>의 경우 시스템 내에서 객실 유형에 사용한 것과 동일한 ID를 사용합니다. Google에서 데이터를 올바르게 표시하려면 시스템과의 일관성이 중요합니다.

이 예에서는 12월에 예약 가능한 회의실 13개의 인벤토리를 설정하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

더 많은 예는 인벤토리 예를 참고하세요.

방법

이 섹션에서는 인벤토리 메시지를 보내는 동안 발생할 수 있는 시나리오를 제공합니다.

시나리오: 회의실이 예약되지 않도록 차단하는 방법

설명

특정 날짜에 이 객실 유형에 예약할 수 있는 남은 회의실이 없음을 나타내야 합니다. 가장 일반적인 이유는 객실이 매진되었기 때문입니다.

해결 방법

<InvCount Count>를 0 값으로 설정하고 원하는 기간을 추가합니다.

샘플

이 샘플은 InvCount를 사용하여 지정된 회의실 및 날짜 (예: 1월의 처음 몇 주)의 인벤토리를 0로 설정하는 방법을 보여줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>