Visão geral das Mensagens de transação

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:

  1. Dados do itinerário: defina os dados do pacote de quartos e do itinerário, incluindo:

    • Preços e inventário de hotéis: defina o preço mínimo de um itinerário que atende a determinados requisitos. Para mais informações, consulte Como atualizar preços. Também é possível remover um quarto do inventário. Para mais informações, consulte Remover o inventário.

    • Pacotes 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 suas mensagens de transação para que os preços fiquem disponíveis o tempo todo. Em alguns casos, o Google determina que os valores no cache não estão atualizados. Por isso, ele pode enviar outras mensagens <Query> (ou, em alguns casos, Consultas de preços em tempo real) para receber 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>.

  2. 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 se referir a eles nas suas mensagens de preços em vez de incluir informações repetitivas sobre quartos e pacotes em cada uma. Para mais informações, consulte Definir metadados de sala e pacote.

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 exceda 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 com que você envia mensagens de transação dependem do modo de entrega:

  • No modo de entrega pull, você envia mensagens de transação quando recebe uma <Query> do Google.
  • No modo de envio de preços alterados, você envia uma mensagem de transação depois de receber e responder a um <HintRequest> e a um <Query>.

Para mais informações, consulte Modos de envio de preços.

Consultas de preços em tempo real

Independentemente do modo de envio, 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 e o número de convidados 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 dicas 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 para 10 minutos para mensagens muito grandes.

Para reduzir bastante o tamanho da mensagem e evitar problemas com tamanhos e tempos limite, use as mensagens de transação para pré-definir os metadados de quartos e pacotes. Também é possível adicionar conteúdo compactado GNU às mensagens adicionando Content-Encoding: gzip aos cabeçalhos da mensagem.