As Mensagens de transação enviam dados sobre quartos, preços e pacotes para o Google. Há dois tipos principais de Mensagens de transação:
Dados de itinerário: defina dados de Categoria de quarto e de itinerário, incluindo:
Preços dos hotéis e inventário: defina o preço mínimo de um itinerário que atenda a determinados requisitos. Para mais informações, consulte Atualizar preços. Também é possível remover um quarto do inventário. Para mais informações, consulte Remover inventário.
Categorias de quarto: define os preços de itinerário para uma combinação de um quarto físico e um pacote de serviços adicionais. Para mais informações, Categorias de quarto. O Google armazena em cache o conteúdo das suas Mensagens de transação para que os preços estejam sempre disponíveis. Em alguns casos, o Google determina que os valores em cache não estão atualizados e pode enviar outras mensagens
<Query>(ou, em alguns casos, consultas de preços em tempo real) para receber os preços atualizados. Esses dados geralmente mudam com muita frequência. Para definir os preços e a disponibilidade das Mensagens de transação, use<Result>.
Metadados de quartos e pacotes: especifica detalhes sobre quartos e pacotes, como descrições, fotos e ocupação máxima. Esses dados não mudam com muita frequência. Para definir Mensagens de transação de metadados, use
<PropertyDataSet>. O Google armazena esses metadados para que você possa consultá-los nas mensagens de preços, em vez de incluir informações repetitivas sobre quartos e pacotes em cada um. Para mais informações, consulte Definir metadados de quartos e pacotes.
O elemento raiz de uma Mensagem de transação é <Transaction>. As mensagens que usam
o elemento <Transaction> como raiz exigem pelo menos um
dos elementos filhos. As mensagens de transação podem ter qualquer número de elementos filhos, desde que o tamanho total da mensagem não exceda 100 MB.
Para conferir exemplos de Mensagens de transação que respondem a solicitações do Google, consulte Referência XML de preços e inventário de quartos (transações).
Modos de transferência
O tipo e a frequência com que você envia Mensagens de transação dependem do modo de entrega:
- Para o modo de transferência Pull, você envia Mensagens de transação quando recebe uma
<Query>do Google. - Para o modo de transferência de preços alterados, você envia uma Mensagem de transação
depois de receber e responder a
<HintRequest>e<Query>.
Para mais informações, consulte Modos de transferência de preços.
Consultas de preço em tempo real
Independentemente do seu modo de transferência, o Google também pode enviar solicitações conhecidas como consultas de preços em tempo real. Essas Mensagens de consulta buscam preços em resposta a uma pesquisa atual. Se você responder dentro do prazo especificado, que geralmente é algumas centenas de milissegundos, seu anúncio pode aparecer no leilão. Seus resultados também podem corresponder melhor ao cliente, incluindo o país, o tipo de dispositivo e o número de hóspedes especificados. Para mais informações, consulte Consultas de preços em tempo real.
Tamanho da mensagem
Você pode incluir qualquer combinação de atualizações de dados em uma única Mensagem de transação, mas há um limite de 100 MB para o tamanho de cada mensagem. Normalmente, todas as solicitações Pull e Hint têm um limite de tempo de resposta de 100 segundos. O tempo limite é um campo configurável e ajustado pelo Google, conforme solicitado. O Google recomenda que você defina o tempo limite como 10 minutos para mensagens muito grandes.
Para reduzir significativamente o tamanho da mensagem e possivelmente evitar problemas com tamanhos
e tempos limite de mensagens, use Mensagens de transação para predefinir os
metadados de quartos e pacotes.
Também é possível adicionar conteúdo compactado do GNU a mensagens adicionando
Content-Encoding: gzip aos cabeçalhos das mensagens.