Лента цен

В ценовом фиде содержится информация о ценах на все круизные маршруты. Включает в себя самую низкую цену за каюту в круизе для каждой валюты. Вы можете загружать ценовые фиды в формате CSV.

В Google доступны следующие валюты:

  • USD
  • CAD
  • AUD
  • GBP

Для интеграции с Google доступна только валюта USD. Вы можете указать другие поддерживаемые валюты, но будет отображаться только USD. В будущем будет добавлена ​​поддержка дополнительных валют из списка. См. список других поддерживаемых валют и соответствующие трехбуквенные коды валют.

Ключевые компоненты

В фиде цен есть обязательные поля, которые нечувствительны к регистру. Некоторые поля являются необязательными и могут быть оставлены пустыми. Отправка необязательных данных повышает качество данных.

It has the following mandatory fields:

  • sail_id : Уникальный идентификатор рейса.

  • currency_code : Уникальный трехбуквенный код конкретной валюты.

  • cruise_line : Название круизной компании.

  • starting_price : Общая стоимость круизного маршрута, включая налоги.

  • sail_url : URL целевой страницы, на которой отображается информация о цене.

Поля

Название поля Необходимый? Тип Описание
sail_id Required string Уникальный идентификатор рейса для конкретного путешествия в маршруте с указанием дат начала и окончания. Например, для маршрута на 5 ночей с 3 остановками, 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 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_url для одного и того же sail_id и currency_code . Например, Fancy Crusies .
updated_at Optional datetime The date and time at which this entry was last updated in the Coordinated Universal time(UTC). This information is useful for identifying stale data. It should follow ISO 8601 format. For example the updated_at is 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

All available fields

Следующий пример демонстрирует все доступные поля в фиде цен:

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

All available fields

Следующий пример демонстрирует все доступные поля в фиде цен:

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