Método de entrega push para preços de hotéis

Observação: o Google oferece suporte ao Push para um conjunto limitado de casos de uso e parceiros. Este documento é destinado a parceiros atuais que usam o Push e para novos parceiros que atendem às diretrizes rígidas do Google para usar o Push.

Se você tiver limitações do sistema que impeçam o suporte aos métodos de entrega Pull ou Pull with hints, use o formulário de contato.

Visão geral do modo de transferência Push

Com o modo de transferência Push, você envia atualizações incrementais sempre que os preços ou a disponibilidade são alterados.

A imagem a seguir mostra o fluxo de solicitação/resposta para o modo de transferência Push:

Observação: antes de usar o Push para enviar atualizações de preço ao Google, você precisa colocar os endereços IP do seu servidor na lista de permissões, conforme descrito abaixo.

Como configurar o push no arquivo de configuração de protocolo

Para atualizar preços com o modo de transferência Push, especifique os seguintes elementos no arquivo de configuração de protocolo. Você faz isso somente quando configura seu ambiente para trabalhar com a Hotel Prices API pela primeira vez:

• <Model>: define o valor do elemento <Model> como "push".
• <WhitelistedIPs>: lista os endereços IP usados para autenticar a comunicação entre você e o Google. O valor desse elemento pode ser uma lista separada por ponto e vírgula dos seus endereços IP ou um intervalo de endereços IP com notação CIDR. Ele assume a forma xxx.xxx.xxx.xxx/YY.

O exemplo a seguir mostra um arquivo de configuração de protocolo para parceiros que usam o Push:

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
  <Model>push</Model>
  <WhiteListedIPs>216.239.32.0/19;64.233.160.0/19</WhiteListedIPs>
</Configuration>

Para mais informações, consulte Arquivo de configuração de protocolo.

Como atualizar preços com push

Para atualizar seus dados com Push, envie uma Mensagem de transação sempre que seus dados forem alterados.

Use as seguintes diretrizes ao enviar a Mensagem de transação:

• Envie a mensagem para o seguinte endpoint:
  • http://www.google.com/travel/hotels/uploads/price
• Use o método HTTP POST.
• Defina o cabeçalho Content-Type como "application/xml".
• O corpo da mensagem precisa estar em conformidade com a sintaxe de Mensagens de transação, conforme descrito em Como definir preços (para atualizações de preços) ou Como definir metadados de quartos e pacotes (para atualizações de metadados).
• Para atualizações de preços, defina um elemento <Result> para cada itinerário que você quiser atualizar. Para atualizações de metadados, defina dados de quartos e de pacotes para cada propriedade que tiver sido alterada.

Para cada Mensagem de transação recebida, o Google responde com uma mensagem HTTP 200 OK do servidor para indicar o sucesso. Se o Google responder com um código de erro HTTP, reenvie a Mensagem de transação. Se você encontrar problemas ao enviar ou receber mensagens, consulte Feeds de solução de problemas.

Envie uma Mensagem de transação para cada itinerário (combinação de propriedade/data de check-in/estadia) em que o preço foi alterado. Você pode enviar até cinco Mensagens de transação por segundo. O Google não bloqueará mensagens enviadas com mais frequência do que cinco por segundo, mas é possível que sua mensagem atinja o tempo limite aguardando a conclusão de outras solicitações.

Para reduzir o tráfego de rede, combine vários elementos <Result> em uma única Mensagem de transação.

O Google normalmente processa seus dados de preço e disponibilidade atualizados em aproximadamente cinco minutos. Os preços serão excluídos após 90 dias.

Para mais informações sobre como usar Mensagens de transação para atualizar preços, consulte Como definir preços.

Como atualizar metadados de quartos e pacotes com push

Para atualizar os metadados de quartos e pacotes, envie atualizações como faria com qualquer outra. Nesse caso, você envia uma Mensagem de transação com as novas informações nos elementos <RoomData> e <PackageData>. Esses elementos são filhos do elemento <PropertyDataSet>.

Para mais informações, consulte Como definir metadados de quartos e pacotes.

Erros no modo de transferência

Se você receber um erro HTTP ao enviar uma Mensagem de transação ao Google, repita a solicitação em intervalos de 1, 5 e 20 minutos. Se o problema persistir após três tentativas, pare de enviar mensagens e entre em contato com seu gerente de contas do Google.

Quando você entrar em contato com seu gerente de contas do Google para relatar o erro HTTP que você recebeu ao enviar uma Mensagem de transação, o Google fará testes para cerca de 10 hotéis enquanto trabalha com você para verificar se seus feeds estão configurados corretamente. Se os testes forem concluídos, o Google rastreará o conjunto completo de hotéis especificado no seu Feed de preços para hotéis. Isso garante que os carregamentos sejam aceitáveis e que os preços permaneçam precisos por três a cinco dias. Depois disso, você receberá uma notificação do Google sobre o lançamento e poderá consultar os resultados ao vivo.

Com que frequência os preços devem ser enviados?

O ideal é enviar todas as atualizações assim que souber que um preço foi alterado. Se você não souber quando os preços mudaram, tente manter os preços atualizados com a maior frequência possível. Isso geralmente inclui vários envios por dia. Normalmente, os itinerários do dia e da semana atuais são enviados com muito mais frequência.