Ir para o conteúdo

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

Google Calendar Server

Navegador web cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Instruções de conexão

Configure o Google Calendar no Google Console

  1. Acesse o Google Console: https://console.cloud.google.com/apis/dashboard

  2. Ative a API do Google Calendar clicando em "Enable APIs and Services" e procurando por Google Calendar

  3. No painel, configure OAuth em "Credentials"

    attachment

  4. Clique em "Create Credentials" no topo da tela e escolha "OAuth client ID"

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

  6. Adicione uma Authorized redirect URI de volta para o provedor de segurança criado em seguida

  7. Clique em "Create" e anote o Client ID e o Client Secret

    Graphical user interface, text, application, email Description automatically generated

    Nota

    A URI de redirecionamento neste exemplo usa o Security Provider nomeado GoogleOAuth.

Adicionando um provedor de segurança OAuth

  1. Acesse o App Builder IDE

  2. No menu Connect, clique no botão Security Providers

  3. Clique em + Security Provider

  4. Forneça os seguintes detalhes:

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

    • Type: Selecione Oauth no menu suspenso

    • Authentication Type: OAuth

    • OAuth Grant: Authorization Code

    • OAuth Client Authentication: Basic

    • OAuth Resource Authentication: Bearer

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

    • Redirect on Challenge: marque para ativar

    • Endpoints:

    • Credentials:

      • Type: Client

      • User Name: Client ID do Google Console

      • Password: Client Secret do Google Console

    • Properties:

    attachment

  5. Clique em Save.

Crie um servidor de dados do Google Calendar

  1. Acesse o App Builder IDE

  2. No menu Connect, clique no botão Data Servers

  3. Clique no botão + Server

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

    • Name: Nome reconhecível

    • Type: Selecione Google Calendar no menu suspenso

    • Security Provider: Selecione o Security Provider criado na etapa anterior

  5. Clique em Save

  6. Clique em Test Connection na seção Testing para testar a conexão OAuth e a URL de redirecionamento

Importar fonte de dados

  1. Acesse o App Builder IDE.

  2. Clique em Data Servers no menu Connect

  3. Em Cloud Database, localize o banco de dados do Google Calendar criado na etapa anterior

  4. Selecione o Google Calendar e clique no botão Detalhes no painel do lado direito

  5. Clique no botão Importar

    attachment

  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 quais registros trazer do Google Calendar

  8. Clique no botão Importar e depois em 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 seu aplicativo App Builder

Criar uma conexão da API REST do Google Calendar

  1. Navegue até o IDE do App Builder

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

  3. Em Serviços Web, clique em REST API na lista suspensa 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 Testes e certifique-se de que Permitir Desafio está marcado

  7. Clique em Salvar e feche a página

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

    attachment

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

    Graphical user interface, text, application Description automatically generated

    attachment

    Graphical user interface, application Description automatically generated

    Graphical user interface, text, application, email Description automatically generated

    attachment

    Graphical user interface, text, application, email Description automatically generated

    Graphical user interface, application Description automatically generated

  10. Para cada Endpoint clique em Testar Conexão. Se esta for a primeira vez que realiza esta ação, o App Builder redirecionará para o Provedor de Desafio do Google. 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. Isto importará todas as tabelas para cada Endpoint no App Builder para uso em seu aplicativo.

Solução de Problemas

Se você enfrentar problemas com o servidor do Google Calendar, recomenda-se seguir estas etapas de solução de problemas:

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

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