Method: accounts.properties.ingestLosPropertyPrices

滞在日数形式の価格を使用して、1 つの宿泊施設の料金を更新します。特定の宿泊施設については、リクエストされた範囲の到着日ごとに、すべての商品と定員を含む LOS 料金がすべて置き換えられます。到着日が指定された期間外の料金には影響しません。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
propertyPrices.property

string

PropertyPrices のリソース名。形式は accounts/{account_id}/properties/{property_id} です。

account_id: この文字列値は「アカウント ID」です。Hotel Center の [アカウント設定] ページに表示されている値。

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:09:00Z の料金の更新が、requestTime が 2019-05-03T14:10:00Z の同じ旅行プランのメッセージの後に受信したものは、後のタイムスタンプ付きのメッセージを優先して破棄されます。

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」です。Hotel Center の [アカウント設定] ページに表示されている値。

property_id: この要素の値は、ホテルリスト フィードのリスティング ID と一致する文字列にする必要があります。

LosArrivalDatePrices

到着期間別にグループ化された滞在日数の料金。

JSON 表現 
{
  "productPrices": [
    {
      object (LosProductPrices)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
フィールド
productPrices[]

object (LosProductPrices)

商品の価格。この productPrices 内のすべての料金は、特定の宿泊施設と到着日の組み合わせに適用されますが、商品は異なります。
startDate

object (Date)

productPrices は、startDate から endDate までのすべての到着日に適用されます。

期間ではなく、1 つの到着日のみを指定する場合は、endDate を省略できます。
endDate

object (Date)

productPrices は、startDate から endDate までのすべての到着日に適用されます。

期間ではなく、1 つの到着日のみを指定する場合は、endDate を省略できます。

日付

誕生日などのように、カレンダーの日付全体またはその一部を表します。時間帯とタイムゾーンは、他の場所で指定されているか、重要ではありません。日付はグレゴリオ暦を基準にしています。これは次のいずれかを表します。

  • ゼロ以外の年、月、日の値を含む完全な日付。
  • 年の値がゼロである月と日（記念日など）。
  • 月と日の値がゼロである単独の年。
  • 日がゼロである年と月（クレジット カードの有効期限など）

関連するタイプ:

JSON 表現 
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

その日付の年。1～9999、または年のない日付を指定する場合は 0 にする必要があります。
month

integer

1 年の中の月。1～12、または月と日のない年を指定する場合は 0 にする必要があります。
day

integer

1 月の中の日付。1～31 で、その年と月に対して有効である必要があります。または、日が重要でない場合に、年のみか年と月を指定するには 0 にする必要があります。

LosProductPrices

商品タイプ（roomTypeId/ratePlanId の組み合わせ）でグループ化された滞在日数の料金。

JSON 表現 
{
  "occupancyPrices": [
    {
      object (LosOccupancyPrices)
    }
  ],
  "roomTypeId": string,
  "ratePlanId": string
}
フィールド
occupancyPrices[]

object (LosOccupancyPrices)

宿泊料金。この occupancyPrices 内のすべての料金は、特定の宿泊施設、到着日、プロダクトの組み合わせに適用されますが、宿泊人数は異なります。
roomTypeId

string

この料金が参照している客室の一意の ID。この ID を使用して、条件の組み合わせデータと客室データで送信したデータを照合します。詳しくは、条件の組み合わせのメタデータをご覧ください。

roomTypeId が入力されている場合は、ratePlanId にも値を入力する必要があります。
ratePlanId

string

この料金が参照しているパッケージ データの一意の ID。この ID を使用して、条件の組み合わせデータと packagedata で送信した内容を照合します。詳しくは、条件の組み合わせのメタデータをご覧ください。

ratePlanId が入力されている場合は、roomTypeId にも値を入力する必要があります。

LosOccupancyPrices

大人の宿泊人数でグループ化された滞在日数の料金。

JSON 表現 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
フィールド
prices[]

object (LosPrices)

滞在日数の料金。prices 内のすべての料金は、特定の宿泊施設、到着日、商品、定員の組み合わせに適用されます。
adults

integer

1 つの部屋で予約できる宿泊客の最大数（大人と子供を含む）。この値は、対応する occupancyPrices フィールド内のすべての料金に対して設定され、1～99 の正の整数である必要があります。

LosPrices

滞在日数の料金。

JSON 表現 
{
  "rates": [
    number
  ],
  "taxes": [
    number
  ],
  "fees": [
    number
  ],
  "rateRuleId": string,
  "currencyCode": string
}
フィールド
rates[]

number

滞在日数の料金の基本料金コンポーネント。

対応する taxes の値を指定した場合、この料金には税金は含まれません（合計金額は該当する税率と税金の合計になります）。

料金のカンマ区切りのリストにする必要があります。インデックス n の値は n+1 の滞在日数に相当します。

一度に 30 個の料金の全 LoS セットを送信する必要があります。30 件未満の料金を送信した場合は、指定されたすべての LoS 料金が通常どおり処理され、残りの料金は LoS 30 までは利用不可として処理されます。30 件を超える価格を送信すると、30 件を超える価格は値下げされます。

予約不可の滞在日数は、0 で表す必要があります。
taxes[]

number

滞在日数の料金の税金コンポーネント。

税金のカンマ区切りのリストである必要があります。インデックス n の値は n+1 の滞在日数に相当します。
fees[]

number

省略可。滞在日数の料金の料金コンポーネント。

料金のカンマ区切りのリストにする必要があります。インデックス n の値は n+1 の滞在日数に相当します。
rateRuleId

string

限定価格の場合、この ID は料金ルール定義ファイルの定義と料金を照合します。

このフィールドの文字数制限は 40 文字です。
currencyCode

string

料金と税金を指定する 3 文字の通貨コード。例: 「USD」ご覧ください

rates と taxes に適用されます。