O feed de preços contém informações de preços para todos os itinerários de cruzeiros. Ele inclui o preço mais barato da cabine de um cruzeiro para 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:
USDCADAUDGBP
O dólar americano é a única moeda disponível para integração com o Google. É possível fornecer outras moedas compatíveis, mas apenas a moeda USD é exibida. Outras moedas da lista serão incluídas 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 dos 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.cruise_line: o nome da companhia de cruzeiros.starting_price: o preço total do itinerário do cruzeiro, incluindo tributos.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, em um itinerário de cinco noites com três paradas, o sail_id é único e permanece o mesmo para todas as três paradas. Um exemplo de sail_id é ABC12345.
Observação: |
| currency_code | Required | currency | O
código de moeda de três letras do preço. Por exemplo,
currency_code pode ser USD.
Observação: |
| cruise_line | Required | string | O nome da companhia de cruzeiros. O 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 tributos. O preço total, incluindo tributos e tarifa do cruzeiro. Esse valor precisa ser o mesmo
exibido 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 ao 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 relacionada aos interiores do cruzeiro, como uma imagem da cabine, do convés e de outras instalações fornecidas no navio. A imagem não precisa ser
da cabine exata listada. Você pode usar outra imagem da cabine.
Um exemplo de image_url é
https://partner.com/images/XXXXX.jpg |
| brand_name | Optional | string | Chave secundária para permitir vários sail_urls 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. Ela precisa seguir o formato
ISO 8601. Por exemplo, updated_at é
2025-01-22T00:00:00+00:00. |
Exemplos
Confira a seguir um exemplo básico de um feed de preços para duas viagens, sendo uma de ida e outra 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.
CSV
Campos obrigatórios
Confira 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 é para todos os campos disponíveis no feed de preço:
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
Confira 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"
}
]
Todos os campos disponíveis
O exemplo a seguir é para todos os campos disponíveis no feed de preço:
[
{
"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"
}
]