Method: accounts.properties.ingestLosPropertyPrices

숙박 기간 형식 가격을 사용하여 단일 숙박 시설의 가격을 업데이트하세요. 특정 숙박 시설의 경우 요청된 기간의 각 도착 날짜에 모든 제품 및 숙박 인원을 포함한 모든 LOS 가격이 대체됩니다. 도착 날짜가 지정된 기간을 벗어나는 가격은 영향을 받지 않습니다.

HTTP 요청

POST https://travelpartnerprices.googleapis.com/v1/{propertyPrices.property=accounts/*/properties/*}:ingestLosPropertyPrices

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
propertyPrices.property

string

PropertyPrices의 리소스 이름입니다. 형식은 accounts/{account_id}/properties/{property_id}입니다.

account_id: 이 문자열 값은 '계정 ID'입니다. 값이 표시됩니다.

property_id: 이 요소의 값은 호텔 목록 피드의 등록정보 ID와 일치하는 문자열이어야 합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "requestTime": string,
  "propertyPrices": {
    "property": string,
    "arrivalDatePrices": [
      {
        "productPrices": [
          {
            object (LosProductPrices)
          }
        ],
        "startDate": {
          object (Date)
        },
        "endDate": {
          object (Date)
        }
      }
    ]
  }
}
필드
requestTime

string (Timestamp format)

필수 항목입니다. LoS 가격 메시지가 전송된 순간으로, RFC 3339 형식의 문자열로 표현됩니다.

requestTime을 통해 지난 24시간 이내에 전송된 메시지는 처리되고 처리되지 않은 메시지는 삭제됩니다.

메시지는 수신한 순서와 관계없이 requestTime 순으로 처리됩니다. 예를 들어 동일한 운항 일정에서 requestTime가 2019-05-03T14:10:00Z인 메시지 이후 수신된 2019-05-03T14:09:00Z requestTime의 가격 업데이트는 이후 타임스탬프가 적용된 메시지로 대체됩니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
propertyPrices.arrivalDatePrices[]

object (LosArrivalDatePrices)

도착 날짜의 가격입니다. 이 arrivalDayPrices 내의 모든 가격은 특정 숙박 시설에 적용되지만 도착일이 다릅니다.

응답 본문

성공한 경우 응답 본문에 PropertyPrices의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/travelpartner

자세한 내용은 OAuth 2.0 개요를 참고하세요.

LosPropertyPrices

숙박 시설 수준에서 지정된 숙박 기간 가격입니다.

JSON 표현 
{
  "arrivalDatePrices": [
    {
      object (LosArrivalDatePrices)
    }
  ],
  "property": string
}
필드
arrivalDatePrices[]

object (LosArrivalDatePrices)

도착 날짜의 가격입니다. 이 arrivalDayPrices 내의 모든 가격은 특정 숙박 시설에 적용되지만 도착일이 다릅니다.
property

string

PropertyPrices의 리소스 이름입니다. 형식은 accounts/{account_id}/properties/{property_id}입니다.

account_id: 이 문자열 값은 '계정 ID'입니다. 값이 표시됩니다.

property_id: 이 요소의 값은 호텔 목록 피드의 등록정보 ID와 일치하는 문자열이어야 합니다.

LosArrivalDatePrices

도착 기간별로 그룹화된 숙박 기간에 따른 가격입니다.

JSON 표현 
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
필드
productPrices[]

object (LosProductPrices)

제품의 가격입니다. 이 productPrices 내의 모든 가격은 특정 숙박 시설, 도착 날짜 조합에 적용되지만 다른 제품에는 적용됩니다.
startDate

object (Date)

productPrices는 startDate과 endDate 사이의 모든 도착 날짜에 적용됩니다(해당 날짜 포함).

범위가 아닌 하나의 도착 날짜만 지정하려는 경우 endDate을 생략할 수 있습니다.
endDate

object (Date)

productPrices는 startDate과 endDate 사이의 모든 도착 날짜에 적용됩니다(해당 날짜 포함).

범위가 아닌 하나의 도착 날짜만 지정하려는 경우 endDate을 생략할 수 있습니다.

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 이는 다음 중 하나를 나타낼 수 있습니다.

  • 연도, 월, 일 값이 0이 아닌 전체 날짜
  • 월과 일, 연도는 0(예: 기념일)
  • 연도만, 월과 일은 0
  • 연도와 월, 일은 0(예: 신용카드 만료일)

관련 유형:

JSON 표현 
{
  "year": integer,
  "month": integer,
  "day": integer
}
필드
year

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

LosProductPrices

제품 유형 (roomTypeId/ratePlanId 조합)별로 그룹화된 숙박 기간 가격입니다.

JSON 표현 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
필드
occupancyPrices[]

object (LosOccupancyPrices)

숙박 인원 가격입니다. 이 occupancyPrices 내의 모든 가격은 특정 숙박 시설, 도착일, 제품 조합에 적용되지만 숙박 인원은 다릅니다.
roomTypeId

string

이 가격이 참조하는 객실의 고유 ID입니다. 이 ID를 사용하여 객실 패키지 데이터를 Roomdata에서 전송한 데이터와 일치시킵니다. 자세한 내용은 Room 번들 메타데이터를 참고하세요.

roomTypeId가 채워지면 ratePlanId도 채워야 합니다.
ratePlanId

string

이 가격이 참조하는 패키지 데이터의 고유 ID입니다. 이 ID를 사용하여 객실 패키지 데이터와 packagedata에 보낸 데이터를 일치시킵니다. 자세한 내용은 Room 번들 메타데이터를 참고하세요.

ratePlanId가 채워지면 roomTypeId도 채워야 합니다.

LosOccupancyPrices

성인 숙박 인원 수를 기준으로 그룹화된 숙박 기간 가격입니다.

JSON 표현 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
필드
prices[]

object (LosPrices)

숙박 기간 가격입니다. prices 내의 모든 가격은 특정 숙박 시설, 도착일, 제품, 숙박 인원 조합에 적용됩니다.
adults

integer

성인과 어린이를 포함하여 객실당 예약할 수 있는 최대 투숙객 수입니다. 이 값은 해당 숙박 가격 필드 내의 모든 요금에 설정되며 1에서 99 사이의 양의 정수여야 합니다.

LosPrices

숙박 기간 가격입니다.

JSON 표현 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
필드
rates[]

number

숙박 기간의 기본 요금 구성요소입니다.

해당하는 taxes 값을 입력하면 이 세율은 세금을 포함하지 않습니다 (총 가격은 관련 세율과 세금의 합계).

쉼표로 구분된 요금 목록이어야 합니다. 색인 n의 값은 n+1의 숙박 기간에 해당합니다.

30개 가격의 전체 LoS 세트를 한 번에 전송해야 합니다. 30개 미만의 금액을 송금하는 경우 Google에서는 제공된 모든 LoS 가격을 정상적으로 처리하고 나머지 요금은 LoS 30까지 사용할 수 없는 것으로 처리합니다. 30개 이상 전송하면 Google에서 30번째 요금을 초과하는 모든 가격을 제공합니다.

이용할 수 없는 숙박 기간은 0로 표시해야 합니다.
taxes[]

number

숙박 기간 가격의 세금 구성요소입니다.

쉼표로 구분된 세금 목록이어야 합니다. 색인 n의 값은 n+1의 숙박 기간에 해당합니다.
fees[]

number

선택사항입니다. 숙박 기간 가격의 수수료 구성요소입니다.

쉼표로 구분된 수수료 목록이어야 합니다. 색인 n의 값은 n+1의 숙박 기간에 해당합니다.
rateRuleId

string

조건부 요금의 경우 이 ID가 요금 규칙 정의 파일의 정의와 요금을 일치시킵니다.

이 입력란의 글자 수 제한은 40자(영문 기준)입니다.
currencyCode

string

요금과 세금이 제공되는 3자리 통화 코드입니다. 예: 'USD' (미국 달러)

rates 및 taxes에 적용됩니다.