O exemplo online da API fica hospedado em:
https://apis.makerplanet.com/open.do?sys=APS
login: master
senha: 1
Acesse o menu lateral, opção Localização e depois Google Calendar. O formulário abaixo será visualizado:
No exemplo, a primeira aba referencia o processo de autenticação.
1) O primeiro campo obtém a URL de autorização, através da qual o dono do calendário autorizará sua aplicação a interagir com o calendário.
- Funções usadas: Google Calendar - Inicializar, Google Calendar - Obter URL para Autenticação.
2) No segundo campo, deve ser inserido o código de autorização (resultado do item 1, após login). Através dele obteremos um objeto credencial do qual (posteriormente) teremos os tokens de acesso.
- Funções usadas: Google Calendar - Obter primeiras credenciais.
3) No terceiro campo, obtemos os tokens de acesso (Access Token e Refresh Token).
- Funções usadas: Google Calendar - Obter Tokens.
obs: O Refresh Token é utilizado posteriormente para atualizar o Access Token, sempre que este expira. A função Google Calendar - Criar Credenciais recebe estes dois parâmetros e atualizará o Access Token caso necessário (este estará disponível no retorno da função).
A segunda aba referencia a interação com calendário, possuindo funcionalidades de:
- Exibição dos calendários
- Exibição de eventos de um calendário
- Criação de evento
- Edição de evento
- Exclusão de evento
obs: Os eventos de edição de eventos estão inoperantes pois necessitam de uma referência válida de evento para executar corretamente.