Página da integração do sistema

Para fazer a integração do Google Agenda com a nossa aplicação web de oficinas, utilizamos a API do Google Agenda, que por sua vez é uma API REST, que pode ser acessada por meio de chamadas HTTP explícitas, expondo assim a maioria dos recursos que podem ser utilizados em nossa aplicação.

Quando um gerente de oficina aceitar uma solicitação de manutenção do proprietário do veículo, um evento com os dados necessários para realizar essa manutenção é criado na conta do Google Agenda do gerente. Os mesmos eventos aparecem na interface de agenda da nossa aplicação web, criada para visualizar e administrar os serviços do dia, semana ou mês.

Recursos da API utilizados

Evento

Um evento é um objeto associado a uma data ou intervalo de tempo específico, sendo identificados por um ID único em um calendário e representados por únicas ocorrências. Além de uma data e hora de início e término, os eventos contêm outros dados como título, descrição, localização, status e fuso horário.

Um fuso horário é configurado nas preferências de cada usuário, sendo especificados usando identificadores padrão de fuso horário da IANA.

Calendário

Um calendário é uma coleção de eventos. Cada calendário tem metadados associados, como título, descrição e fuso horário padrão do calendário.

Foi utilizado o calendário principal do usuário para registrar os eventos. Este calendário é criado automaticamente para cada nova conta de usuário e seu ID geralmente corresponde ao endereço de e-mail principal do usuário. Enquanto a conta existir, sua agenda principal nunca poderá ser excluída ou "não pertencente" ao usuário.

Autorização de solicitações para a API

Estamos usando o protocolo de autorização 'OAuth 2.0', que consiste em um token de acesso fornecido pelo Google, no qual é formado pelo ID do cliente e uma senha.

Cada solicitação que o sistema envia para a API do Google Agenda deve incluir um token de autorização. O token também identifica seu sistema para o Google. Se o Google determinar que sua solicitação e o token são válidos, ele retornará os dados solicitados.

Limites de uso da API

A API do Google Agenda é de graça e tem um limite de 1,000,000 queries por dia e por usuário, o que é muito aquém do que está sendo utilizado.

A única limitação encontrada é que cada gerente de oficina será obrigado a possuir uma conta do Google para utilizar o sistema.