Home	Sprints	Requisitos	Arquitetura	Configuração	Mockups	Banco de Dados	Instalação	Gerência de Projeto	CI

Página da integração do sistema

Para fazer a integração do Google Agenda com a nossa aplicação web de oficinas foi utilizado a API do Google Agenda, que por sua vez é uma API REST, podendo assim ser acessada através de chamadas HTTP explícitas para expor a maioria dos recursos dos quais foram utilizados na aplicação.

Do ponto de vista do gerente da oficina, ao 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 em sua conta do Google Agenda. Os mesmos eventos criados aparecem na interface de agenda da nossa aplicação web, criada para visualizar e administrar os serviços do dia, semana e mês.

Recursos da API utilizados

Evento

Um evento é um objeto associado a uma data ou intervalo de tempo específico, sendo identificado por um ID único em um calendário, e em nosso caso, está sendo representado como única ocorrência. Além de uma data e hora de início e término, os eventos contêm outros dados como título, descrição, cor e fuso horário.

Um fuso horário é configurado nas preferências de cada usuário, sendo especificado usando o identificador 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 e é formado pelo ID do cliente e uma senha.

Cada solicitação que o sistema envia para a API do Google Agenda deve incluir seu token de autorização. O token também identifica seu sistema para o Google e se for determinado 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.