Feed de preços

O feed de preços contém informações sobre todos os itinerários de cruzeiro. Ele inclui o preço mais barato da cabine para um cruzeiro de cada tipo de moeda. É possível fazer upload de feeds de preços no formato CSV.

As seguintes moedas estão disponíveis no Google:

• USD
• CAD
• AUD
• GBP

O USD é a única moeda disponível para integração com o Google. Você pode fornecer outras moedas aceitas, mas apenas o USD será mostrado. Outras moedas da lista serão aceitas no futuro. Consulte a lista de outras moedas aceitas e o código de moeda de três letras correspondente.

Principais componentes

O feed de preços tem campos obrigatórios que não diferenciam maiúsculas de minúsculas. Alguns campos são opcionais e podem ser deixados em branco. O envio de dados opcionais melhora a qualidade de dados.

Ele tem os seguintes campos obrigatórios:

• sail_id: um identificador de navegação exclusivo para uma viagem específica.

• currency_code: um código de moeda de três letras exclusivo para a moeda específica.

  Ponto chave: sail_id e currency_code são concatenados para formar uma chave primária composta e precisam ser exclusivos.

• cruise_line: o nome da linha de cruzeiro.

• starting_price: o preço total do itinerário do cruzeiro, incluindo impostos.

• sail_url: o URL da página de destino que mostra as informações de preço.

Campos

Nome do campo	Obrigatório?	Tipo	Descrição
sail_id	Required	string	Identificador de navegação exclusivo para uma viagem específica no itinerário com data de início e término. Por exemplo, para um itinerário de 5 noites com 3 paradas, o sail_id é exclusivo e permanece igual para todas as 3 paradas. Um exemplo de sail_id é ABC12345. Observação: sail_id e currency_code são concatenados para formar uma chave primária composta e precisam ser exclusivos.
currency_code	Required	currency	O código de moeda de três letras para o preço. Por exemplo, currency_code pode ser USD. Observação: sail_id e currency_code são concatenados para formar uma chave primária composta e precisam ser exclusivos.
cruise_line	Required	string	O nome da linha de cruzeiro. cruise_line é obrigatório para agregadores que vendem em nome de outras empresas. Por exemplo, Norwegian Cruise Line.
starting_price	Required	decimal	O preço total do itinerário do cruzeiro, incluindo impostos. O preço total incluindo impostos e tarifa de cruzeiro. Esse valor precisa ser o mesmo mostrado no site do parceiro ao abrir o URL da oferta. Por exemplo 1000.00.
sail_url	Required	URL	O URL da página de destino que mostra as informações de preço. Por exemplo, https://partner.com/path.html&id=XYZ12345
offer_desc	Optional	string	Uma descrição da oferta associada ao preço ou nome da cabine. Por exemplo, Inside Cabin.
image_url	Optional	URL	O URL de uma imagem que representa o itinerário. A imagem precisa estar estar relacionada aos interiores do cruzeiro, como uma imagem da cabine, do convés do navio e de outras instalações fornecidas no navio. A imagem não precisa ser da cabine exata que está listada. Você pode usar uma imagem de cabine diferente. Um exemplo de image_url é https://partner.com/images/XXXXX.jpg
brand_name	Optional	string	Chave secundária para permitir vários sail_url's para o mesmo sail_id e currency_code. Por exemplo, Fancy Crusies.
updated_at	Optional	datetime	A data e a hora em que essa entrada foi atualizada pela última vez no Horário Universal Coordenado(UTC). Essas informações são úteis para identificar dados desatualizados. Ele precisa seguir o formato ISO 8601. Por exemplo, o updated_at é 2025-01-22T00:00:00+00:00.

Exemplos

A seguir, um exemplo básico de um feed de preços para duas navegações, em que uma é uma viagem de ida e a outra é uma viagem de ida e volta.

Os exemplos mostram os formatos CSV e JSON. Os campos sail_id e currency_code são concatenados para formar a chave primária composta e precisam ser exclusivos para cada linha.

Importante: não use o formato JSON. Ele é apenas para fins informativos. Todos os feeds precisam estar no formato CSV.

CSV

Campos obrigatórios

A seguir, um exemplo dos campos obrigatórios no feed de preços:

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

Todos os campos disponíveis

O exemplo a seguir é um exemplo de todos os campos disponíveis no feed de preços:

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 (para fins informativos)

Campos obrigatórios

A seguir, um exemplo dos campos obrigatórios no feed de preços:

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

Observação: todos os feeds precisam estar no formato CSV. Não use o formato JSON.

Todos os campos disponíveis

O exemplo a seguir é um exemplo de todos os campos disponíveis no feed de preços:

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

Observação: todos os feeds precisam estar no formato CSV. Não use o formato JSON.