... | ... | @@ -3,18 +3,18 @@ |
|
|
|
|
|
# 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.
|
|
|
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.
|
|
|
|
|
|
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.
|
|
|
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 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 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 especificados usando identificadores padrão de fuso horário da IANA.
|
|
|
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 ####
|
|
|
|
... | ... | @@ -24,10 +24,9 @@ Foi utilizado o calendário principal do usuário para registrar os eventos. Est |
|
|
|
|
|
### 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.
|
|
|
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 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.
|
|
|
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 ###
|
|
|
|
... | ... | |