Servidor de agendamento pronto

Você precisa de um servidor de reserva para permitir que a Central de ações faça callbacks para criar e atualizar reservas em seu nome. Isso permite que a Central de ações crie compromissos, agendamentos e reservas com você em nome do usuário.

Para saber como configurar a conexão com seus servidores de agendamento do sandbox e de produção, consulte Configurar credenciais do servidor de agendamento.

Conclua as seguintes tarefas do Booking Server Ready antes de migrar para as atualizações em tempo real:

Cada tarefa é marcada como concluída e fica verde quando você envia detalhes precisos do inventário em tempo real para solicitações do servidor de reservas pelo fluxo de reservas da caixa de simulação. Os marcos do servidor de reserva são analisados em um período de 14 dias.

Implementar uma interface da API REST

Implemente uma interface de API com base em REST. Isso permite que o Google envie solicitações do servidor de agendamento por HTTPS.

Para implementar uma interface de API, configure um servidor de agendamento de desenvolvimento ou sandbox que se conecte ao ambiente de sandbox da Central de ações. Mude para um ambiente de produção somente depois que o servidor do sandbox for totalmente testado.

Todas as solicitações do servidor de reserva do Google são relacionadas ao URL do servidor de reserva definido na página Servidor de reserva. Por exemplo, se o URL estiver definido como api.example.com/google, todas as solicitações HealthCheck serão enviadas para api.example.com/google/v3/HealthCheck.

Verifique se o endpoint correto do servidor de agendamento está configurado para os ambientes de sandbox e produção com o seletor de ambiente.

Segurança e autenticação

Toda a comunicação com seu servidor de agendamento acontece por HTTPS usando autenticação básica. Para ajudar a configurar o servidor, use uma ferramenta de verificação SSL ou TLS disponível publicamente, como o teste de servidor SSL da Qualys.

Todas as solicitações que o Google faz ao seu servidor de agendamento são autenticadas com autenticação básica HTTPS. Você pode inserir as informações básicas de autenticação, senha e nome de usuário do seu servidor de agendamento na página de configuração do servidor de agendamento da Central de ações. As credenciais precisam ser alteradas a cada seis meses.

Criar o servidor de agendamento

O servidor de reservas determina como a integração se comunica com seu sistema e faz ou atualiza reservas. Para configurar a conexão com seus servidores de agendamento do sandbox e de produção, consulte Configurar credenciais do servidor de agendamento.

Toda resposta que seu servidor de agendamento envia a uma solicitação do Reservar com o Google precisa conter detalhes precisos e em tempo real do inventário. A tabela a seguir mostra os métodos de cada implementação e inclui links para os formatos de protocolo de serviço:

Método Definição Resposta Solicitação HTTP
Carregamento da página BatchAvailabilityLookup

Quando um usuário clica em Reservar uma mesa para seu comerciante, a solicitação BatchAvailabilityLookup é chamada no carregamento da página.

O payload contém vários slots com base nos seus últimos envios de feed, que o Reservar com o Google considera disponíveis.

 A resposta precisa incluir todas as solicitações de slot e a disponibilidade atual do slot. Isso impede que slots indisponíveis sejam mostrados. POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup clique no slot Quando um usuário vê os horários disponíveis para agendamento e clica em um deles, a solicitação BatchAvailabilityLookup é chamada para o clique no horário. A resposta precisa representar a disponibilidade atual e real do horário. Se ele estiver reservado antes do clique no slot, retorne a resposta de que não está disponível. POST /v3/BatchAvailabilityLookup/
CreateBooking Quando um usuário confirma que quer reservar um período selecionado no modal de reserva, a solicitação CreateBooking é enviada.

A resposta precisa representar o sucesso ou a falha da reserva.

Se a reserva falhar, retorne o motivo específico da falha. Por exemplo, o slot foi reservado antes da chamada da resposta CreateBooking.

Se um agendamento for criado, a resposta vai incluir um booking_id exclusivo para se referir a ele em solicitações ou atualizações futuras.

 POST /v3/CreateBooking/
UpdateBooking Depois de fazer uma reserva pelo Reservar com o Google, o usuário pode modificar o agendamento. Quando o usuário atualiza ou cancela a reserva, uma solicitação UpdateBooking é enviada. Assim como a resposta CreateBooking, sua resposta a UpdateBooking precisa representar o sucesso da reserva ou retornar o motivo específico de uma falha. POST /v3/UpdateBooking/
HealthCheck A Central de ações faz chamadas regulares ao seu servidor de reservas para confirmar se a infraestrutura está ativa e funcionando.

Use o Código de status HTTP para indicar o status de veiculação do seu servidor. Retorne um código de status HTTP 200 se o servidor estiver ativo e funcionando corretamente.

Para indicar um erro ou desativar temporariamente sua integração, retorne o código de status HTTP não 2xx apropriado.

 GET /v3/HealthCheck/

Fluxo de reserva do sandbox

Para conferir o fluxo de reserva da Sandbox, acesse a visualização Inventário da Central de ações. A coluna RwG - E2E da visualização "Inventário" mostra um link Ao vivo (no Sandbox) para o fluxo de reserva do Sandbox para comerciantes do Sandbox que foram correspondidos e têm disponibilidade futura.

Estas são as ações no fluxo de reserva:

  • Quando você clica no link RwG - E2E, ele aciona uma solicitação BatchAvailabilityLookup no carregamento da página e apresenta a disponibilidade conhecida do comerciante.
  • Quando você clica em um horário de reserva, isso aciona a BatchAvailabilityLookup no pedido de clique no slot e apresenta o modal de reserva.
  • Conclua uma reserva com o modal de reserva para enviar a solicitação CreateBooking.
  • Depois de concluir uma reserva no ambiente de sandbox, a conta usada para criar a reserva recebe um e-mail de confirmação com os detalhes dela.
  • Para acionar o método UpdateBooking, mude ou cancele a reserva no e-mail.

HealthCheck

Implemente o método HealthCheck no sandbox e na produção. Esse método retorna o status de integridade do servidor de agendamento. Ele permite que o Google monitore continuamente o estado de veiculação do servidor de reservas.

Solicitação: nenhuma

Valor de retorno: nenhum

Use o Código de status HTTP para indicar o status de veiculação do seu servidor.

Se o servidor estiver ativo e funcionando corretamente, retorne um código de status HTTP 200. Para indicar um erro, retorne um dos códigos de status HTTP.