價格動態饋給包含所有郵輪行程的價格資訊。其中包含每種貨幣類型的最便宜郵輪艙房價格。你可以上傳 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 | 這個項目上次更新的日期和時間，以世界標準時間(UTC) 為準。這項資訊可用於識別過時資料。日期格式應採用
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"
}
]