Hotel API

Nota

Esta versão beta do Hotel Price Ads está disponível apenas para participantes selecionados. Para obter informações sobre como participar no programa de versão beta, contacte o seu gestor de conta ou inscreva-se aqui.

A API e a documentação estão sujeitas a alterações.

A API de Hotel permite-lhe gerir as suas campanhas publicitárias e licitações do hotel.

Noções básicas...

Quando obtém acesso ao Hotel Price Ads, o serviço configura uma subconta predefinida e um grupo hoteleiro que contém os hotéis do seu feed de hotel. A subconta fornece a organização lógica de nível superior dos anúncios de preços do hotel. Pode pensar nisso como uma campanha de alojamento (anteriormente campanhas hoteleiras). Pode ter várias subcontas.

Uma subconta especifica o orçamento diário da campanha, a oferta máxima permitida, a oferta predefinida e os multiplicadores de ofertas para anúncios que não especificam ofertas ou multiplicadores.

Os grupos hoteleiros fornecem outro nível para agrupar logicamente anúncios de preços de hotéis. Um grupo hoteleiro pertence a uma única subconta. O grupo hoteleiro predefinido que o serviço cria para si tem o nome Desagrupar. Contém todos os hotéis do feed inicial do hotel e todos os novos hotéis daqui para a frente.

Um grupo hoteleiro especifica a oferta predefinida e os multiplicadores de ofertas para anúncios que não especificam ofertas ou multiplicadores. Se não especificar ofertas e multiplicadores, o grupo herda-os da subconta.

Depois de configurar a sua subconta e grupo hoteleiro, pode começar a importar os dados do feed do hotel. Para obter informações, consulte Tem o feed do hotel configurado?

Os hotéis pertencem a um único grupo hoteleiro. Os hotéis especificam a oferta e os multiplicadores de ofertas a utilizar para o anúncio do hotel. Se não especificar ofertas e multiplicadores, o hotel herda-os do grupo hoteleiro ou subconta, por essa ordem.

Para obter informações sobre como mudar o hotel para um grupo hoteleiro diferente, consulte Associar hotéis a grupos hoteleiros.

O que precisa de estar no lugar antes de começar?

Precisará de credenciais e de ter os feeds do hotel configurados. Para obter informações, consulte Introdução.

O gestor de conta também precisa de permitir que a sua conta utilize Anúncios de Preços de Hotel nos ambientes de produção e sandbox.

Como devo proceder para gerir os meus recursos?

As secções seguintes mostram como gerir as suas subcontas, grupos hoteleiros e hotéis. Para obter informações sobre os pontos finais, o cabeçalho, os parâmetros de consulta e os recursos, veja Referência da API do Hotel.

Tópico	Descrição
Trabalhar com subcontas	Fornece informações sobre como listar as suas subcontas, obter uma única subconta e atualizar uma subconta.
Trabalhar com grupos hoteleiros	Fornece informações sobre como listar os grupos hoteleiros de uma subconta, obter um único grupo hoteleiro, adicionar um grupo hoteleiro e atualizar um grupo hoteleiro.
Trabalhar com hotéis	Fornece informações sobre como listar todos os hotéis na subconta, listar hotéis num grupo hoteleiro, obter um único hotel de um grupo hoteleiro e atualizar um hotel.
Associar um hotel a um grupo hoteleiro	Fornece informações sobre como associar um hotel a um grupo hoteleiro.

Para obter exemplos de código, veja Exemplos.