Guia de conexão do Google Calendar para Jitterbit App Builder

Visão geral

Este guia descreve os requisitos do sistema e as instruções para conectar o App Builder a um servidor de banco de dados do Google Calendar.

Requisitos do sistema

Servidor de banco de dados

Servidor do Google Calendar

Navegador da web do cliente

• Chrome: 84+

• Firefox: 73+

• Safari: 13.0.1+

• Edge: 84+

Instruções de conexão

Configurar o Google Calendar no Google Console

1. Navegue até o Google Console: https://console.cloud.google.com/apis/dashboard

2. Ative a API do Google Calendar clicando em "Ativar APIs e Serviços" e pesquisando por Google Calendar

3. No painel, configure o OAuth em "Credenciais"

   

4. Clique em "Criar Credenciais" no topo da tela e escolha "ID do cliente OAuth"

5. Escolha o tipo de Aplicação "Aplicativo Web" e dê um nome ao seu aplicativo

6. Adicione um URI de redirecionamento autorizado de volta ao provedor de segurança criado a seguir

7. Clique em "Criar" e anote o ID do Cliente e o Segredo do Cliente

   

   Nota

   O URI de redirecionamento neste exemplo usa o Provedor de Segurança chamado GoogleOAuth.

Adicionando um provedor de segurança OAuth

1. Navegue até o App Builder IDE

2. No menu Conectar, clique no botão Provedores de Segurança

3. Clique em + Autenticação de Usuário em Autenticação de Usuário

4. Forneça os seguintes detalhes:

   • Nome: GoogleOAuth (deve ser nomeado assim para corresponder ao redirecionamento)

   • Tipo: Selecione Oauth no menu suspenso

   • Tipo de Autenticação: OAuth

   • Concessão OAuth: Código de Autorização

   • Autenticação do Cliente OAuth: Básica

   • Autenticação de Recurso OAuth: Bearer

   • Proprietário do Token: Depende do uso pretendido. Use Cliente se for um calendário para toda a organização, caso contrário, use Usuário se o calendário estiver conectado a usuários individuais que precisam modificar eventos em seus Google Calendars.

   • Redirecionar em Desafio: marque para habilitar

   • Endpoints:

     • Endpoint de Autorização: https://accounts.google.com/o/oauth2/auth

     • Endpoint de Token: https://oauth2.googleapis.com/token

   • Credenciais:

     • Tipo: Cliente

     • Nome de Usuário: ID do Cliente do Google Console

     • Senha: Segredo do Cliente do Google Console

   • Propriedades:

     • Escopos: https://www.googleapis.com/auth/calendar

     • Outros escopos estão enumerados na Documentação do Google. Vários escopos podem ser adicionados e devem ser separados por um espaço.

   

5. Clique em Salvar.

Criar um servidor de dados do Google Calendar

1. Navegue até o App Builder IDE

2. No menu Conectar, clique no botão Servidores de Dados

3. Clique no botão + Servidor

4. Forneça as seguintes informações:

   • Nome: Nome Reconhecível

   • Tipo: Selecione Google Calendar no menu suspenso

   • Provedor de Segurança: Selecione o Provedor de Segurança criado na etapa anterior

5. Clique em Salvar

6. Clique em Testar Conexão na seção de Testes, para testar a conexão OAuth e a URL de redirecionamento

Importar fonte de dados

1. Navegue até o App Builder IDE.

2. Clique em Servidores de Dados no menu Conectar

3. Sob Banco de Dados em Nuvem, encontre o Banco de Dados Google Calendar criado na etapa anterior

4. Selecione o Google Calendar e clique no botão Detalhes no painel à direita

5. Clique no botão Importar

   

6. Clique para expandir Capacidades de Importação

7. Opcionalmente, clique no botão Editar e defina um Padrão de Importação para instruir o App Builder sobre quais registros trazer do Google Calendar

8. Clique no botão Importar, depois Prosseguir

9. O App Builder executará a importação em segundo plano

10. Após a conclusão da importação, expanda Utilitários e clique em Tabelas para visualizar os dados importados do Google Calendar Server

11. As Tabelas importadas deste servidor agora estão disponíveis para uso em sua aplicação App Builder

Criar uma conexão com a API REST do Google Calendar

1. Navegue até o App Builder IDE

2. Clique em Servidores de Dados no menu de conexão

3. Em Serviços Web, clique em API REST no dropdown Tipo

4. Para URL, insira https://www.googleapis.com/calendar/v3

5. Clique para expandir Configurações de Segurança e selecione o Provedor de Segurança do Google Calendar criado nas etapas anteriores

6. Clique para expandir Teste e certifique-se de que Permitir Desafio esteja marcado

7. Clique em Salvar e feche a página

8. Para o Servidor de Dados que você acabou de criar, clique em Detalhes. Isso o levará à página vista abaixo:

   

9. Adicione os seguintes Endpoints e Parâmetros de Endpoint:

   

   

   

   

   

   

   

10. Para cada Endpoint, clique em Testar Conexão. Se esta for a primeira vez que você está realizando isso, o App Builder redirecionará para o Google Challenge Provider. Faça login com sua conta do Google e clique em Aceitar na página seguinte. Você será levado de volta ao App Builder após realizar essas etapas.

11. Para cada Endpoint, clique em Descobrir. Isso importará todas as tabelas para cada Endpoint para o App Builder para uso em seu aplicativo.

Solução de Problemas

Se você encontrar problemas com o servidor do Google Calendar, estas etapas de solução de problemas são recomendadas:

1. Ative o registro de dados para gerar arquivos de log e dados, que você pode baixar e inspecionar.

2. Consulte a documentação do CData ADO.NET Provider para Google Calendar para informações detalhadas.