價格動態饋給包含所有郵輪行程的價格資訊。包括每種幣別的郵輪最便宜艙房價格。你可以上傳 CSV 格式的價格動態饋給。
Google 支援下列幣別：
USDCADAUDGBP
與 Google 整合時，只能使用美元。你可以提供其他支援的貨幣，但只會顯示美元。日後將支援清單中的其他幣別。請參閱其他支援的幣別清單，以及對應的三字母幣別代碼。
重要元件
價格動態饋給含有不區分大小寫的必填欄位。部分欄位為選填，可以留空。傳送選用資料可提升資料品質。
其中包含下列必填欄位：
sail_id：特定行程的專屬航行 ID。currency_code：特定貨幣的專屬三字母貨幣代碼。cruise_line：郵輪公司名稱。starting_price：郵輪行程的總價，含稅。sail_url：顯示價格資訊的到達網頁網址。
欄位
| 欄位名稱 | 是否必要？ | 類型 | 說明 |
|---|---|---|---|
| sail_id | Required | string | 行程中特定行程的專屬航行 ID，附有開始和結束日期。舉例來說，如果行程為 5 晚，且有 3 個停靠點，則 sail_id 是唯一的，且所有 3 個停靠點都必須相同。sail_id 的範例為 ABC12345。
注意： |
| currency_code | Required | currency | 價格的
三字母貨幣代碼。舉例來說，currency_code 可以是 USD。注意： |
| cruise_line | Required | string | 郵輪公司名稱。cruise_line是代表其他公司銷售的整合商必備的驗證。例如：Norwegian Cruise Line。 |
| starting_price | Required | decimal | 郵輪行程的總價，包括稅金。總價，包括稅金和郵輪票價。這個值應與合作夥伴網站上顯示的值相同；開啟方案網址時，例如 1000.00。 |
| sail_url | Required | URL | 顯示價格資訊的到達網頁網址。例如：https://partner.com/path.html&id=XYZ12345 |
| offer_desc | Optional | string | 與價格或艙等名稱相關的方案說明。例如：Inside Cabin。 |
| image_url | Optional | URL | 可代表行程的圖片網址。圖片應與郵輪內部相關，例如客艙、甲板和船上其他設施的圖片。圖片不一定要是所列小屋的確切樣貌。你可以使用其他車廂圖片。image_url 的範例為
https://partner.com/images/XXXXX.jpg |
| brand_name | Optional | string | 次要鍵，可為相同的 sail_id 和 currency_code 允許多個 sail_url。例如：Fancy Crusies。 |
| updated_at | Optional | datetime | 這個項目上次更新的日期和時間(世界標準時間)。這項資訊有助於識別過時資料。請遵守
ISO 8601 格式。例如，updated_at 為 2025-01-22T00:00:00+00:00。 |
範例
以下是兩個航程的價格動態饋給基本範例，其中一個航程是單程，另一個是來回。
範例會顯示 CSV 和 JSON 格式。sail_id和 currency_code 欄位會串連形成複合主鍵，且每個資料列不得重複。
CSV
必填欄位
以下是價格動態饋給中必填欄位的範例：
sail_id; currency_code; cruise_line; starting_price; sail_url
12345; USD; Happy Cruises Company; 2198; https://partner.com/path.html&id=XYZ12345
54321; GBP; Happy Cruises Company; 449; https://partner.com/path.html&id=ABC12345
54321; USD; Happy Cruises Company; 430; https://partner.com/path.html&id=ABC12345
所有可用欄位
以下範例顯示價格動態饋給中所有可用的欄位：
sail_id; currency_code; cruise_line; starting_price; sail_url; offer_desc; image_url; brand_name; updated_at
12345; USD; Happy Cruises Company; 2198; https://partner.com/path.html&id=XYZ12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Fancy Cruises; 2025-06-20T00:00:00+00:00
54321; GBP; Happy Cruises Company; 449; https://partner.com/path.html&id=ABC12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Caribbean Crusies; 2025-06-20T00:00:00+00:00
54321; USD; Happy Cruises Company; 430; https://partner.com/path.html&id=ABC12345; Inside Cabin;https://partner.com/images/XXXXX.jpg; Caribbean Crusies; 2025-06-20T00:00:00+00:00
JSON (僅供參考)
必填欄位
以下是價格動態饋給中必填欄位的範例：
[
{
"sail_id": "12345",
"currency_code": "USD",
"cruise_line": "Happy Cruises Company",
"starting_price": 2198,
"sail_url": "https://partner.com/path.html&id=XYZ12345"
},
{
"sail_id": "54321",
"currency_code": "GBP",
"cruise_line": "Happy Cruises Company",
"starting_price": 449,
"sail_url": "https://partner.com/path.html&id=XYZ12345"
},
{
"sail_id": "54321",
"currency_code": "USD",
"cruise_line": "Happy Cruises Company",
"starting_price": 430,
"sail_url": "https://partner.com/path.html&id=XYZ12345"
}
]
所有可用欄位
以下範例顯示價格動態饋給中所有可用的欄位：
[
{
"sail_id": "12345",
"currency_code": "USD",
"cruise_line": "Happy Cruises Company",
"starting_price": 2198,
"sail_url": "https://partner.com/path.html&id=XYZ12345",
"offer_desc": "Inside Cabin",
"image_url": "https://partner.com/images/XXXXX.jpg",
"brand_name": "Fancy Crusies",
"updated_at": "2025-06-20T00:00:00+00:00"
},
{
"sail_id": "54321",
"currency_code": "GBP",
"cruise_line": "Happy Cruises Company",
"starting_price": 449,
"sail_url": "https://partner.com/path.html&id=XYZ12345",
"offer_desc": "Inside Cabin",
"image_url": "https://partner.com/images/XXXXX.jpg",
"brand_name": "Caribbean Crusies",
"updated_at": "2025-06-20T00:00:00+00:00"
},
{
"sail_id": "54321",
"currency_code": "USD",
"cruise_line": "Happy Cruises Company",
"starting_price": 430,
"sail_url": "https://partner.com/path.html&id=XYZ12345",
"offer_desc": "Inside Cabin",
"image_url": "https://partner.com/images/XXXXX.jpg",
"brand_name": "Caribbean Crusies",
"updated_at": "2025-06-20T00:00:00+00:00"
}
]