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: criar uma «chave de acesso» no Google (sem ela, ninguém consegue ligar a conta).
  • Parte B - para cada utilizador: como ligar a sua conta Google.
  • Parte C - opcional: calendário privado através da sua própria «chave de acesso» (necessário apenas em casos específicos).

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

A Google exige que cada aplicação que se liga ao calendário tenha a sua própria «chave de acesso» - as chamadas credenciais OAuth (duas sequências longas de caracteres: Client ID e Client Secret). São criadas uma vez, gratuitamente, na consola Google Cloud. Demora cerca de 10 minutos. Siga estes passos:

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

Esta é a janela que os utilizadores verão 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 para o tipo Externo: na secção Público (Audience), clique em Publicar aplicação (Publish app) para que o estado passe de «Em teste» para «Em produção» (In production). No modo de teste, a Google desliga todas as contas a cada 7 dias e é necessário voltar a ligá-las.

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.
    • Nota: NÃO cole este endereço no campo «Origens JavaScript autorizadas» (Authorized JavaScript origins) - é outro campo e dará erro. Deixe-o vazio.
  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).

Com o tipo Externo, a Google mostrará um aviso único ao ligar a conta: «A Google não verificou esta aplicação». É normal para aplicações empresariais - clique em Avançadas (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 «A Google não verificou esta aplicação», clique em Avançadas e depois em Aceder (é uma ação única; consulte a 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 o período dos últimos 30 dias até um ano no futuro - pode alterá-lo nos campos «Período» 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, os eventos têm as cores da Google: a cor atribuída ao evento ou, se não tiver nenhuma, a cor do calendário selecionado (as cores muito claras são ligeiramente escurecidas para facilitar a leitura). Os eventos enviados do Task Manager para a Google recebem a cor mais próxima da paleta da 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 da Google» (com uma ligação para o abrir na 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 importa as alterações imediatamente - é útil quando acabou de alterar algo na Google e quer vê-lo aqui de imediato. No final, a mensagem indica quantos eventos foram adicionados, alterados e removidos. O mesmo botão («Sincronizar agora») está disponível 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 a Google: depois de selecionar um calendário, é ativada a opção «Adicionar novos eventos do Task Manager a este calendário» (visível junto à ligação nas Definições). Ao ativá-la, são também enviados de imediato os eventos futuros que ainda não tinham sido enviados. Se houver várias ligações, a exportação funciona para uma única ligação selecionada - ao selecionar outra conta, o destino muda. Os eventos exportados mantêm a sua cor e continuam a sincronizar nos dois sentidos (se os eliminar na Google, também serão eliminados aqui).
  • A eliminação de um evento também o elimina na Google (a janela de edição indica-o claramente); «Anular» na barra restaura 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.
Task Manager: calendário com eventos importados da conta Google.
Os eventos do Google aparecem na grelha ao lado das tarefas e das ausências da equipa.

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 as suas próprias credenciais - Parte C).
  • A Google indica «Não tem acesso» numa conta pessoal - a credencial empresarial é do tipo Interno; use a Parte C.
  • Erro «volte a ligar a conta» - a Google revogou o acesso (por exemplo, devido a uma alteração de palavra-passe, à revogação da autorização na conta Google ou porque a aplicação está em modo de teste - consulte a 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 apresentado pelo Task Manager (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.