Práticas recomendadas

As práticas recomendadas a seguir se aplicam à integração completa do Reservar com o Google e podem ser usadas para evitar problemas de usabilidade e desempenho. Isso pode levar à remoção do inventário.

Feeds

  • Se um serviço não tiver um comprimento definido, defina duration_sec no feed de disponibilidade como uma das opções a seguir:
    • O número de segundos necessários para realizar o serviço de maneira razoável.

    • O número médio de segundos necessários para concluir o serviço.

  • Torne a entrada do campo Category no feed do comerciante específica. Por exemplo, um restaurante pode enviar um tipo específico, como francês ou japonês. Para mais detalhes, consulte os tipos de lugar para ver possíveis valores de categoria.

  • Defina os Termos de Serviço específicos do comerciante no campo Terms do feed do comerciante para que a seguinte observação seja exibida abaixo do botão Reservar:

    Ao continuar, você concorda com os Termos de Serviço do <merchant>.
    Nesse caso, "Termos de Serviço" é um link que, quando clicado, exibe o texto definido no campo de texto terms.

  • Compactar feeds usando gzip

Servidor de agendamento

Para otimizar sua integração da API Maps Booking, faça o seguinte:

  • Sempre use carimbos de data/hora UNIX no formato UTC.
  • Gere um ID exclusivo quando uma nova reserva na API CreateBooking for chamada.

atualizações em tempo real;

Para garantir a melhor experiência do usuário durante o processo de reserva, faça o seguinte:

  • Para uma implementação padrão, use a API BookingNotificações para mudar o horário de início, a duração e o estado da reserva, como o cancelamento ou o não comparecimento de um agendamento.
  • Sempre que você precisar fazer uma mudança na reserva do Reservar com o Google, sempre envie atualizações do sistema em tempo real com a API BookingNotification em tempo real para que os dados não fiquem desatualizados no Reservar com o Google. Por exemplo, é possível cancelar, reagendar ou atualizar uma reserva no seu sistema no Reservar com o Google.
  • Para cada atualização de reserva de UpdateBookingRequest, verifique se o valor de UpdateBookingResponse contém o ID de reserva e se todos os campos atualizados precisam refletir o novo valor.
  • Se a RTU do inventário for implementada
    • Atualize a disponibilidade apenas em lotes de 100 a 1.000 slots por chamada de API.
    • Use os campos *Restrict (como startTimeRestrict) para restringir o destino de edição, reduzir o tamanho do payload e evitar o reenvio de dados inalterados.
    • Se você executar várias linhas de execução, implemente uma espera exponencial para evitar erros de limitação. Se você não implementar uma espera exponencial corretamente, poderá receber um erro de cota RESOURCE_EXHAUSTED. É possível tentar novamente a espera exponencial para processá-las. No entanto, se você descobrir que seu servidor costuma atingir cotas ao executar ReplaceServiceAvailability, configure-o para substituição em lote da disponibilidade. Essa solução evita erros de cota porque reduz o número de chamadas de API que o serviço precisa fazer.
  • Defina seus limites de tempo de resposta de chamada de API para menos de um segundo. Verifique se o servidor pode processar cinco consultas por segundo (QPS) com latência de subsegundos em pelo menos 95% do tempo.