料金フィード

料金フィードには、すべてのクルーズ旅行プランの料金情報が含まれています。これには、通貨の種類ごとに、クルーズの最安値のキャビン料金が含まれます。料金フィードは CSV 形式でアップロードできます。

Google で使用できる通貨は次のとおりです。

  • USD
  • CAD
  • AUD
  • GBP

Google との統合に使用できる通貨は USD のみです。他のサポートされている通貨を指定することもできますが、表示されるのは USD のみです。今後、リストにある他の通貨もサポートされる予定です。サポートされている他の通貨と対応する 3 文字の通貨コードのリストをご覧ください。

主要コンポーネント

料金フィードには、大文字と小文字が区別されない必須フィールドがあります。一部のフィールドは省略可能で、空白のままにできます。省略可能なデータを送信すると、データ品質が向上します。

次の必須フィールドがあります。

  • sail_id: 特定の旅行の固有の航海識別子。

  • currency_code: 特定の通貨の固有の 3 文字の通貨コード 。

  • cruise_line: クルーズ会社の名前。

  • starting_price: 税金を含むクルーズ旅行プランの合計料金。

  • sail_url: 料金情報が表示されるランディング ページの URL。

フィールド

フィールド名 必須かどうか 種類 説明
sail_id Required string 開始日と終了日を含む旅行プランの特定の旅行の固有の航海識別子。 たとえば、3 つの寄港地がある 5 泊の旅行プランの場合、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 税金を含むクルーズ旅行プランの合計料金。税金とクルーズ料金を含む合計料金。これは、パートナーのウェブサイトに表示される値 と同じである必要があります。オファーの URL を開くと表示されます。例: 1000.00。
sail_url Required URL 料金情報が表示されるランディング ページの URL。例: https://partner.com/path.html&id=XYZ12345
offer_desc Optional string 料金またはキャビン名に関連付けられたオファーの説明。例: Inside Cabin。
image_url Optional URL 旅行プランを表す画像の URL。画像は、 キャビン、船のデッキ、船内のその他の設備など、クルーズの内装に関連している必要があります。画像は、リストに記載されているキャビンとまったく同じである必要はありません。別のキャビンの画像を使用できます。 image_url の例: https://partner.com/images/XXXXX.jpg
brand_name Optional string 同じ sail_id と currency_code に対して複数の sail_url's を許可するセカンダリ キー。例: Fancy Crusies。
updated_at Optional datetime このエントリが最後に更新された日時（ 協定世界時（UTC））。この情報は、 （現在地が）最新でないデータを特定するのに役立ちます。 ISO 8601 形式に準拠する必要があります。たとえば、updated_at は 2025-01-22T00:00:00+00:00 です。

例

次の例は、2 つの航海の料金フィードの基本的な例です。1 つは片道旅行、もう 1 つは往復旅行です。

この例では、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"
  }
]