料金フィード

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

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

  • USD
  • CAD
  • AUD
  • GBP

Google との統合で使用できる通貨は 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 を許可するセカンダリ キー。例: Fancy Crusies
updated_at Optional datetime このエントリが最後に更新された日時（協定世界時（UTC））。この情報は、古いデータを特定する場合に役立ちます。 ISO 8601 形式に従う必要があります。たとえば、updated_at は 2025-01-22T00:00:00+00:00 です。

例

次の例は、1 便が片道で、もう 1 便が往復の 2 便の料金フィードの基本的な例です。

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