As mensagens de transação enviam dados sobre quartos, preços e pacotes ao Google. Há dois tipos principais de mensagens de transação:
Dados do itinerário: defina os dados do itinerário e da categoria de quarto, incluindo:
Preços e inventário de hotéis: defina o preço mínimo para um itinerário que atenda a determinados requisitos. Para mais informações, consulte Como atualizar preços. Também é possível remover uma sala do inventário. Para mais informações, consulte Remover inventário.
Categorias de quarto: defina os preços do itinerário para uma combinação de um quarto físico e um pacote de serviços adicionais. Para mais informações, consulte Categorias de quarto. O Google armazena em cache o conteúdo das mensagens de transação para que os preços estejam disponíveis a qualquer momento. Em alguns casos, o Google determina que os valores no cache não estão atualizados e envia mais mensagens
<Query>(ou consultas de preços em tempo real) para receber preços atualizados. Esses dados costumam mudar com muita frequência. Para definir preços e disponibilidade de mensagens de transação, use<Result>.
Metadados de quarto e pacote: especificam 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 se referir a eles nas mensagens de preços, em vez de incluir informações repetitivas sobre quartos e pacotes em cada uma delas. Para mais informações, consulte Definir metadados de sala e pacote.
O elemento raiz de uma mensagem de transação é <Transaction>. As 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 exceda 100 MB.
Para 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 com que você envia mensagens de transação dependem do seu modo de entrega:
- No modo de entrega por pull, você envia mensagens de transação quando recebe um
<Query>do Google. - No modo de transferência de preços alterados, você envia uma mensagem de transação
depois de receber e responder a um
<HintRequest>e<Query>.
Para mais informações, consulte Modos de entrega de preços.
Consultas de preços em tempo real
Independente do seu modo de entrega, 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 período especificado, que geralmente é de algumas centenas de milissegundos, seu anúncio poderá aparecer no leilão. Seus resultados também podem corresponder melhor ao cliente, incluindo o país e o tipo de dispositivo, além do número de hóspedes especificados. Para mais informações, consulte Consultas de preços em tempo real.
Tamanho da mensagem
É possível incluir qualquer combinação de atualizações de dados em uma única mensagem de transação, mas há um limite de 100 MB no tamanho de cada mensagem. Normalmente, todas as solicitações de pull e dica 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 definir o tempo limite como 10 minutos para mensagens muito grandes.
Para reduzir muito o tamanho das mensagens e evitar problemas com tamanhos e tempos limite, use as mensagens de transação para pré-definir os metadados de quarto e pacote.
Você também pode adicionar conteúdo compactado com GNU às mensagens adicionando
Content-Encoding: gzip aos cabeçalhos.