|
|
|
|[Home](home)|[Sprints](sprints)|[Requisitos](requisitos)|[Arquitetura](arquitetura)|[Configuração](configuracao)|[Mockups](mockups)|[Banco de Dados](banco_dados)|[Instalação](instalacao)|[Gerência de Projeto](gp)|[CI](ci)|
|
|
|
|
|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
# 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. |
|
|
\ No newline at end of file |
