价格 Feed

价格 Feed 包含所有游轮行程的价格信息。其中包含每种货币对应的最便宜的舱位价格。您可以上传 CSV 格式的价格 Feed。

Google 支持以下币种：

  • USD
  • CAD
  • AUD
  • GBP

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

关键组件

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

其中包含以下必填字段：

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

  • currency_code：特定货币的唯一由 3 个字母组成的货币代码。

  • cruise_line：游轮公司的名称。

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

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

字段

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

注意：sail_id 和 currency_code 会串联形成复合主键，并且必须是唯一的。
currency_code Required currency 价格的 由 3 个字母组成的货币代码。例如，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"
  }
]