价格 Feed

价格 Feed 包含所有邮轮行程的价格信息。它包含每种币种的邮轮最便宜的舱位价格。您可以上传 CSV 格式的价格 Feed。

以下币种可用于 Google 服务：

  • USD
  • CAD
  • AUD
  • GBP

与 Google 集成时，唯一可用的币种是美元。您可以提供其他受支持的币种，但系统只会显示美元。未来将支持列表中的其他币种。请参阅其他支持的货币及其对应的三字母货币代码列表。

关键组件

价格 Feed 包含不区分大小写的必填字段。有些字段是可选的，可以留空。发送可选数据有助于提高数据质量。

它包含以下必填字段：

  • sail_id：特定行程的唯一航行标识符。

  • currency_code：特定币种的唯一三字母货币代码。

  • cruise_line：邮轮公司的名称。

  • starting_price：邮轮行程的总价（含税）。

  • sail_url：显示价格信息的着陆页的网址。

字段

字段名称 是否必需？ 类型 说明
sail_id Required string 行程中特定旅程的唯一航程标识符，包含开始日期和结束日期。例如，对于包含 3 个停留点的 5 晚行程，sail_id 是唯一的，并且对于所有 3 个停留点都保持不变。sail_id 的一个示例是 ABC12345。

注意： sail_id 和 currency_code 连接在一起形成复合主键，并且必须是唯一的。
currency_code Required currency 价格的 三字母货币代码。例如，currency_code 可以是 USD。

注意： sail_id 和 currency_code 连接在一起形成复合主键，并且必须是唯一的。
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。

示例

以下是两个航程的价格 Feed 的基本示例，其中一个航程是单程，另一个是往返。

示例中同时显示了 CSV 和 JSON 格式。sail_id、currency_code 字段会串联起来以形成复合主键，并且对于每一行都必须是唯一的。

CSV

必填字段

以下是价格 Feed 中必填字段的示例：

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

所有可用字段

以下示例展示了价格 Feed 中的所有可用字段：

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（仅供参考）

必填字段

以下是价格 Feed 中必填字段的示例：

[
  {
    "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"
  }
]

所有可用字段

以下示例展示了价格 Feed 中的所有可用字段：

[
  {
    "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"
  }
]