Method: accounts.properties.ingestLosPropertyPrices

使用設定入住天數價格，更新單一房源的價格。針對指定房源，要求範圍內的每個抵達日期都會取代所有 LOS 價格，包括所有產品和可住人數。抵達指定日期範圍以外的價格則不受影響。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
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 Price 訊息傳送的時間，以 RFC 3339 格式字串表示。

系統會處理過去 24 小時內透過 requestTime 傳送的所有訊息，並捨棄未遷移的訊息。

無論傳送順序為何，訊息的處理順序都是 requestTime。例如，對於在 requestTime 為 2019-05-03T14:10:00Z 的相同行程訊息之後，收到 2019-05-03T14:09:00Z 為 2019-05-03T14:09:00Z 的價格更新，系統會予以捨棄，以便改用較晚時間戳記的訊息。requestTime

RFC3339 世界標準時間「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 之間的所有抵達日期 (含頭尾)。

如果只嘗試指定一個抵達日期 (而非範圍)，則可省略 endDate。
endDate

object (Date)

productPrices 會套用至 startDate 到 endDate 之間的所有抵達日期 (含頭尾)。

如果只嘗試指定一個抵達日期 (而非範圍)，則可省略 endDate。

日期

代表完整或部分的日曆日期，例如生日。您可以指明時段和時區，或者在其他地方指定時間或時區。日期以公曆為基準。可能代表下列其中一項：

  • 完整日期，具有非零的年、月和日值。
  • 日期為 0 的月份和日期，例如週年紀念日。
  • 有 1 年，第 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，比對 Room Bundle 資料與你在會議室資料中傳送的資料。詳情請參閱「會議室套件中繼資料」。

如果已填入 roomTypeId，則也必須填入 ratePlanId。
ratePlanId

string

這個價格所參照的套件資料專屬 ID。請使用這個 ID，將 Room Bundle 資料與您在 packagedata 中傳送的資料進行比對。詳情請參閱「會議室套件中繼資料」。

如果已填入 ratePlanId，則也必須填入 roomTypeId。

LosOccupancyPrices

入住天數 (依成人入住人數分組)。

JSON 表示法 
{
  "prices": [
    {
      object (LosPrices)
    }
  ],
  "adults": integer
}
欄位
prices[]

object (LosPrices)

入住天數。prices中的所有價格皆適用於特定房源、抵達日期、產品和可住人數組合。
adults

integer

每間會議室可預訂的房客人數上限，包括成人和兒童。這個值會針對對應 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

用於提供房價和稅金的三字母貨幣代碼。例如「USD」代表美金

適用於 rates 和 taxes。