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: definir dados de itinerário e Categoria de quarto, 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: defina 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 Mensagens de transação para que os preços estejam sempre disponíveis. Em alguns casos, o Google determina que os valores no cache não estão atualizados. Por isso, ele pode enviar mais mensagens
<Query>(ou, em alguns casos, Consultas de preços em tempo real) para receber preços atualizados. Normalmente, esses dados mudam com muita frequência. Para definir o preço e a disponibilidade de 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>. Mensagens que usam
o elemento <Transaction> como elemento 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 seja maior que 100 MB.
Para conferir exemplos de Mensagens de transação que respondem a solicitações do Google, consulte a Referência XML de preços e inventário de quartos (transações).
Modos de transferência
O tipo e a frequência de envio das Mensagens de transação dependem do seu modo de entrega:
- Para o modo de transferência Pull, você envia Mensagens de transação quando receber 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ços em tempo real
Independentemente do 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 normalmente é de algumas centenas de milissegundos, seu anúncio poderá ser incluído 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ço 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 de Pull e Hint têm um limite de tempo de resposta de 100 segundos. O tempo limite é um campo configurável que pode ser ajustado pelo Google, conforme solicitado. O Google recomenda que você defina o tempo limite como 10 minutos para mensagens muito grandes.
Para reduzir consideravelmente o tamanho da mensagem e evitar problemas com o tamanho
e o tempo limite das mensagens, use as Mensagens de transação para predefinir os
metadados de quartos e pacotes.
Você também pode adicionar conteúdo compactado do GNU às mensagens adicionando
Content-Encoding: gzip aos cabeçalhos das mensagens.