O Task Manager consegue mostrar os eventos do seu Calendário Google no seu próprio Calendário e sincronizá-los nos dois sentidos: uma alteração no Google aparece sozinha no Task Manager (a cada poucos minutos), e uma alteração no Task Manager fica de imediato guardada no Google. Os eventos do Google são visíveis apenas para si - a ligação é pessoal, como uma caixa de correio.

Pode ligar várias contas ao mesmo tempo - por exemplo, o calendário da empresa e o seu pessoal. Cada ligação tem o seu próprio calendário e funciona de forma independente.

As instruções têm três partes:

  • Parte A - para o administrador, uma única vez: criação do «passe» no Google (sem isto ninguém consegue ligar a conta).
  • Parte B - para cada utilizador: como ligar a sua conta Google.
  • Parte C - para quem quiser: calendário privado através do seu próprio «passe» (necessário apenas em casos especiais).

Parte A (administrador, uma única vez): passe no Google

O Google exige que cada aplicação que se liga ao calendário tenha o seu próprio «passe» - as chamadas credenciais OAuth (duas cadeias de carateres longas: Client ID e Client Secret). Criam-se uma vez, gratuitamente, na consola Google Cloud. Demora cerca de 10 minutos. Passo a passo:

Passo 1. Crie o projeto

  1. Aceda a console.cloud.google.com e inicie sessão com uma conta Google (de preferência a da empresa).
  2. No topo da página, clique na lista de projetos e escolha Novo projeto (New project).
  3. Dê-lhe um nome, por exemplo Task Manager, clique em Criar (Create) e aguarde um pouco até o Google o criar. Certifique-se de que fica selecionado (o nome é visível no topo).

Passo 2. Ative a Google Calendar API

  1. No menu da esquerda, escolha APIs e serviços → Biblioteca (APIs & Services → Library).
  2. Na pesquisa, escreva Google Calendar API, clique no resultado e depois em Ativar (Enable).

Passo 3. Configure o ecrã de consentimento

É a janela que os utilizadores veem ao ligar a conta («A aplicação X pede acesso ao calendário»).

  1. No menu da esquerda, escolha APIs e serviços → Ecrã de consentimento OAuth (OAuth consent screen). Na versão mais recente da consola, esta secção chama-se Plataforma de autenticação Google (Google Auth Platform) - nesse caso, clique em Começar (Get started).
  2. Indique o nome da aplicação (por exemplo, Task Manager) e o seu e-mail de contacto.
  3. Tipo de destinatários (User type / Audience):
    • Interno (Internal) - apenas se a empresa usar o Google Workspace. É a opção mais prática: sem avisos, mas só se podem ligar contas do domínio da empresa (uma conta Gmail pessoal não se liga - ver Parte C).
    • Externo (External) - em qualquer outro caso. Funciona com qualquer conta Google.
  4. Guardar / Criar.
  5. Importante no tipo Externo: na secção Destinatários (Audience), clique em Publicar aplicação (Publish app) para que o estado mude de «Teste» para «Em produção» (In production). No modo de teste, o Google desliga todos de 7 em 7 dias e é preciso ligar novamente.

Passo 4. Crie o cliente OAuth (ou seja, o verdadeiro passe)

  1. No menu da esquerda, escolha APIs e serviços → Credenciais (Credentials) - ou Clientes (Clients) na nova consola.
  2. Clique em Criar credenciais → ID de cliente OAuth (Create credentials → OAuth client ID).
  3. Tipo de aplicação: Aplicação Web (Web application).
  4. Nome: por exemplo, Task Manager.
  5. Agora o campo mais importante: URIs de redirecionamento autorizados (Authorized redirect URIs). Clique em Adicionar URI e cole EXATAMENTE o endereço que o Task Manager mostra em Definições → Avançado → Calendário Google (OAuth) - termina em /api/gcal/oauth-callback.
    • Atenção: NÃO cole este endereço no campo „Origens JavaScript autorizadas" (Authorized JavaScript origins) - é um campo diferente e vai gerar um erro. Deixe-o em branco.
  6. Clique em Criar. O Google mostra o ID de cliente (Client ID, termina em .apps.googleusercontent.com) e a Chave secreta do cliente (Client Secret, começa por GOCSPX-). Copie ambos.

Passo 5. Cole o passe no Task Manager

  1. No Task Manager, abra Definições → Avançado → Calendário Google (OAuth).
  2. Cole o Client ID e o Client Secret, clique em Guardar.

Pronto - a partir de agora, qualquer utilizador pode ligar a sua conta (Parte B).

No tipo Externo, o Google mostra ao ligar um aviso único «O Google não verificou esta aplicação». Isto é normal em aplicações empresariais - clica-se em Avançado (Advanced) e depois em Aceder a: <nome> (Go to...). O limite para uma aplicação não verificada é de 100 contas ligadas.

Parte B (cada utilizador): ligue a sua conta

  1. Abra Definições → Perfil → Calendário Google.
  2. Clique em Ligar conta Google.
  3. O Google pergunta com que conta iniciar sessão - escolha aquela cujo calendário quer ver (da empresa ou pessoal).
  4. Se aparecer o aviso «O Google não verificou esta aplicação» - clique em Avançado e depois em Aceder (é uma única vez, ver Parte A).
  5. Autorize o acesso ao calendário (Permitir / Allow).
  6. Volta ao Task Manager. Abra novamente Definições → Perfil → Calendário Google - junto à conta ligada aparece a lista dos seus calendários.
  7. Escolha o calendário e clique em Importar. Passado um instante, os eventos aparecem no Calendário do Task Manager.

Também quer um segundo calendário (por exemplo, pessoal)? Volte à mesma secção e clique novamente em Ligar conta Google - desta vez inicie sessão com a segunda conta. Cada ligação é um cartão separado na lista, com o seu próprio calendário e o botão Desligar.

A importação abrange uma janela de 30 dias para trás até um ano para a frente - pode alterá-la nos campos «Janela» de cada ligação.

Parte C (avançado): calendário privado através de um passe próprio

Quando é necessário? Sobretudo quando o passe da empresa é do tipo Interno (Internal) - nesse caso, o Google não deixa entrar o seu Gmail pessoal. Pode então criar o seu próprio passe na sua conta pessoal do Google e ligar-se através dele:

  1. Percorra toda a Parte A na sua conta pessoal do Google (projeto próprio, tipo Externo, publicação, Client ID e Secret próprios). No passo 4.5, cole o endereço de redirecionamento indicado na secção abaixo.
  2. No Task Manager, abra Definições → Perfil → Calendário Google e expanda Ligar com credenciais próprias (avançado).
  3. Aí encontra o endereço de redirecionamento (para o passo 4.5) e os campos Client ID e Client Secret - cole os seus e clique em Ligar com credenciais próprias.
  4. A seguir, como na Parte B: início de sessão, consentimento, escolha do calendário, Importar.

As suas credenciais são guardadas encriptadas e usadas apenas para esta ligação. O administrador não precisa de fazer nada.

Como os eventos do Google se comportam no Task Manager

  • No Calendário, têm as cores do Google: a cor atribuída ao evento ou, na sua ausência, a cor do calendário escolhido (as cores muito claras são ligeiramente escurecidas para melhor leitura). Os eventos enviados do Task Manager para o Google recebem a cor mais próxima da paleta do Google - as cores são aproximadas, porque as paletas das duas aplicações são diferentes. Ao clicar, a janela de edição indica claramente «Evento do Google» (com uma ligação para abrir no Google).
  • Edita-os como qualquer outro evento: arrastar para outra data, alterar horas e conteúdo, eliminar. Cada uma destas alterações fica também guardada no Calendário Google - e as alterações feitas no Google chegam ao Task Manager sozinhas, a cada poucos minutos.
  • Não quer esperar? Clique no ícone de sincronização (duas setas em círculo) na barra superior da janela do Calendário. Só aparece quando tem o Calendário Google ligado e traz as alterações de imediato - útil quando acabou de mudar algo no Google e quer vê-lo aqui já. No final, uma mensagem indica quantos eventos foram adicionados, alterados e removidos. O mesmo botão («Sincronizar agora») está junto à ligação em Definições → Perfil → Calendário Google.
  • Quando a última sincronização automática falha, o ícone fica laranja e, ao passar o cursor, mostra o motivo. Clicar tenta novamente.
  • Os novos eventos criados no Task Manager também são enviados para o Google: ao selecionar um calendário, ativa-se a opção «Adicionar a este calendário os novos eventos do Task Manager» (visível junto à ligação, em Definições). Ativar esta opção envia de imediato também os eventos futuros que ainda não tinham sido enviados. Com várias ligações, a exportação funciona apenas para uma selecionada - marcar noutra conta muda o destino. O evento exportado mantém a sua cor e continua a sincronizar-se nos dois sentidos (eliminá-lo no Google elimina-o também aqui).
  • Eliminar um evento elimina-o também no Google (a janela de edição indica-o claramente); «Anular» na barra repõe o evento em ambos os lados.
  • Clicar abre a janela de edição habitual com a ligação abrir no Google.
  • Os eventos futuros lembram-se tal como os eventos normais do Task Manager (notificação à hora de início); os passados entram em silêncio, para o histórico do dia.
  • Os eventos de dia inteiro aparecem a partir das 8:00 (os de vários dias - até às 18:00 do último dia) e mantêm-se como eventos de dia inteiro no Google mesmo depois de serem movidos para outro dia.
  • Desligar (numa ligação específica) remove do seu calendário os eventos importados dessa conta - no Google nada desaparece. As restantes ligações continuam a funcionar.

Eliminação dos dados da conta Google

  • Desligar uma conta: Definições → Perfil → Calendário Google → Desligar na ligação escolhida. Desaparecem os tokens e os eventos importados do seu calendário (no Google nada muda); as restantes ligações continuam a funcionar.
  • Eliminar as credenciais da instância (administrador): Definições → Avançado → Calendário Google (OAuth) → Eliminar credenciais. Apaga o Client ID e o Client Secret e desliga todos os utilizadores ligados através dessas credenciais (os seus eventos importados desaparecem do Task Manager; no Google nada muda). As ligações com credenciais próprias (Parte C) permanecem intactas.
  • Pode também revogar sempre o acesso da aplicação à sua conta Google diretamente no Google: myaccount.google.com → Segurança → Ligações a aplicações de terceiros.

Resolução de problemas

  • «O administrador ainda não configurou as credenciais» - a Parte A não foi concluída (ou pode usar credenciais próprias - Parte C).
  • O Google indica «Não tem acesso» com uma conta pessoal - a autorização da empresa é do tipo Interno; utilize a Parte C.
  • Erro «ligue a conta novamente» - o Google revogou o acesso (por exemplo, alteração de palavra-passe, revogação da autorização na conta Google, ou a aplicação ficou em modo de teste - ver Parte A, passo 3.5). Desligue e volte a ligar a conta.
  • Erro «redirect_uri_mismatch» ao ligar - o endereço de redirecionamento no Google Cloud é diferente do que o Task Manager apresenta (Parte A, passo 4.5). Corrija-o no Google Cloud (Credenciais → O seu cliente OAuth).
  • A sincronização ocorre sempre que alguém está a usar a aplicação (agendamento integrado); depois de uma pausa mais longa, a primeira sincronização acontece pouco depois de abrir a aplicação.
  • Uma alteração do Google não chegou, apesar de já terem passado alguns minutos? Clique no ícone de sincronização na barra do Calendário - vai receber o número de alterações obtidas ou o motivo concreto da falha. O estado da última execução (data e eventual erro) também é visível em Definições → Perfil → Calendário Google.