Servidor de agendamento pronto

Você precisa de um servidor de agendamento para 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 os servidores de agendamento do sandbox e de produção, consulte Configurar credenciais do servidor de agendamento.

Conclua as seguintes tarefas de preparação do servidor de agendamento antes de passar 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 agendamento pelo fluxo de reserva do sandbox. Os marcos do servidor de agendamento são analisados por 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 de 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 de sandbox for totalmente testado.

Todas as solicitações do servidor de agendamento do Google são relacionadas ao URL do servidor de agendamento set on the Booking Server page. Por exemplo, se o URL estiver definido como api.example.com/google, todas as HealthCheck solicitações 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 de produção com o seletor de ambiente.

Segurança e autenticação

Toda a comunicação com o servidor de agendamento acontece por HTTPS usando a 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 servidor de agendamento são autenticadas com a autenticação básica de HTTPS. Você pode inserir as informações básicas de autenticação, senha e nome de usuário do 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 agendamento determina como a integração se comunica com seu sistema e faz ou atualiza reservas. Para configurar a conexão com os servidores de agendamento do sandbox e de produção, consulte Configurar credenciais do servidor de agendamento.

Espera-se que cada resposta que o servidor de agendamento faz a uma solicitação do Reservar com o Google contenha detalhes precisos do inventário em tempo real. 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 de página BatchAvailabilityLookup

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

O payload contém vários slots com base nos seus uploads de feed mais recentes, 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 evita que slots indisponíveis sejam exibidos. POST /v3/BatchAvailabilityLookup/
Slot BatchAvailabilityLookup clicado Quando um usuário recebe slots disponíveis para reserva e clica em um slot, a solicitação BatchAvailabilityLookup é chamada para o clique no slot. A resposta precisa representar a disponibilidade atual e real do slot. 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 horário selecionado no modal de reserva, a CreateBooking solicitação é enviada.

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

Se a reserva falhar, você precisará retornar o motivo específico da falha. Por exemplo, o slot foi reservado antes que a CreateBooking resposta fosse chamada.

Se uma reserva bem-sucedida for criada, a resposta incluirá um booking_id exclusivo para se referir à reserva em solicitações ou atualizações futuras.

 POST /v3/CreateBooking/
UpdateBooking Depois que uma reserva é feita pelo Reservar com o Google, um usuário pode escolher modificar a reserva. Quando o usuário atualiza ou cancela a reserva, uma solicitação UpdateBooking é enviada. Assim como a CreateBooking resposta, 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 servidor de agendamento para confirmar se a infraestrutura está ativa e em execução.

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 a integração, retorne o código de status HTTP não 2xx apropriado.

 GET /v3/HealthCheck/

Critérios de marco

Para concluir o marco de preparação do servidor de agendamento, sua integração precisa atender aos seguintes critérios nos ambientes de sandbox e de produção:

Método Número de solicitações necessárias (sandbox) Número de solicitações necessárias (produção) Taxa de sucesso necessária
Carregamento de página BatchAvailabilityLookup 20 20 90%
Slot BatchAvailabilityLookup clicado 20 20 90%
CreateBooking 10 3 90%
UpdateBooking 10 3 90%

Fluxo de reserva do sandbox

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

Confira a seguir 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, ele aciona a solicitação BatchAvailabilityLookup no clique do 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 da reserva.

  • Para acionar o método UpdateBooking, altere 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 agendamento.

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, ou, para indicar um erro, retorne um dos códigos de status HTTP.