Task Manager potrafi pokazywać wydarzenia z Twojego Kalendarza Google w swoim Kalendarzu i synchronizować je w obie strony: zmiana w Google sama pojawia się w Task Managerze (co kilka minut), a zmiana w Task Managerze od razu zapisuje się w Google. Wydarzenia z Google widzisz wyłącznie Ty - połączenie jest osobiste, jak skrzynka pocztowa.

Możesz połączyć kilka kont naraz - np. firmowy kalendarz i swój prywatny. Każde połączenie ma własny kalendarz i działa niezależnie.

Instrukcja ma trzy części:

  • Część A - dla administratora, jednorazowo: założenie „przepustki" w Google (bez tego nikt nie połączy konta).
  • Część B - dla każdego użytkownika: jak połączyć swoje konto Google.
  • Część C - dla chętnych: prywatny kalendarz przez własną „przepustkę" (potrzebne tylko w szczególnych przypadkach).

Część A (administrator, jednorazowo): przepustka w Google

Google wymaga, aby każda aplikacja łącząca się z kalendarzem miała swoją „przepustkę" - tzw. poświadczenia OAuth (dwa długie ciągi znaków: Client ID i Client Secret). Zakłada się je raz, za darmo, w konsoli Google Cloud. Zajmuje to ok. 10 minut. Po kolei:

Krok 1. Załóż projekt

  1. Wejdź na console.cloud.google.com i zaloguj się kontem Google (najlepiej firmowym).
  2. U góry strony kliknij listę projektów i wybierz Nowy projekt (New project).
  3. Nazwij go np. Task Manager, kliknij Utwórz (Create) i poczekaj chwilę, aż Google go założy. Upewnij się, że jest wybrany (nazwa widoczna u góry).

Krok 2. Włącz Google Calendar API

  1. W menu z lewej wybierz Interfejsy API i usługi → Biblioteka (APIs & Services → Library).
  2. W wyszukiwarce wpisz Google Calendar API, kliknij wynik, a potem Włącz (Enable).

Krok 3. Skonfiguruj ekran zgody

To okno, które użytkownicy zobaczą przy łączeniu konta („Aplikacja X prosi o dostęp do kalendarza").

  1. W menu z lewej wybierz Interfejsy API i usługi → Ekran zgody OAuth (OAuth consent screen). W nowszej wersji konsoli ta sekcja nazywa się Platforma uwierzytelniania Google (Google Auth Platform) - kliknij wtedy Rozpocznij (Get started).
  2. Podaj nazwę aplikacji (np. Task Manager) i swój e-mail kontaktowy.
  3. Rodzaj odbiorców (User type / Audience):
    • Wewnętrzny (Internal) - tylko jeśli firma używa Google Workspace. Najwygodniej: bez ostrzeżeń, ale łączyć się mogą wyłącznie konta z domeny firmy (prywatny Gmail się nie połączy - patrz Część C).
    • Zewnętrzny (External) - w każdym innym przypadku. Zadziała dla dowolnych kont Google.
  4. Zapisz / Utwórz.
  5. Ważne przy typie Zewnętrzny: w sekcji Odbiorcy (Audience) kliknij Opublikuj aplikację (Publish app), aby status zmienił się z „Testowanie" na „W wersji produkcyjnej" (In production). W trybie testowym Google odłącza wszystkich co 7 dni i trzeba łączyć się od nowa.

Krok 4. Utwórz klienta OAuth (czyli właściwą przepustkę)

  1. W menu z lewej wybierz Interfejsy API i usługi → Dane logowania (Credentials) - albo Klienci (Clients) w nowej konsoli.
  2. Kliknij Utwórz dane logowania → Identyfikator klienta OAuth (Create credentials → OAuth client ID).
  3. Typ aplikacji: Aplikacja internetowa (Web application).
  4. Nazwa: np. Task Manager.
  5. Teraz najważniejsze pole: Autoryzowane identyfikatory URI przekierowania (Authorized redirect URIs). Kliknij Dodaj URI i wklej DOKŁADNIE adres, który Task Manager pokazuje w Ustawienia → Zaawansowane → Kalendarz Google (OAuth) - kończy się na /api/gcal/oauth-callback.
    • Uwaga: NIE wklejaj tego adresu w pole „Autoryzowane źródła JavaScript" (Authorized JavaScript origins) - to inne pole, zgłosi błąd. Zostaw je puste.
  6. Kliknij Utwórz. Google pokaże Identyfikator klienta (Client ID, kończy się na .apps.googleusercontent.com) oraz Tajny klucz klienta (Client Secret, zaczyna się od GOCSPX-). Skopiuj oba.

Krok 5. Wklej przepustkę do Task Managera

  1. W Task Managerze otwórz Ustawienia → Zaawansowane → Kalendarz Google (OAuth).
  2. Wklej Client ID i Client Secret, kliknij Zapisz.

Gotowe - od teraz każdy użytkownik może połączyć swoje konto (Część B).

Przy typie Zewnętrzny Google pokaże przy łączeniu jednorazowe ostrzeżenie „Google nie zweryfikował tej aplikacji". To normalne dla aplikacji firmowych - klika się Zaawansowane (Advanced), a potem Otwórz: <nazwa> (Go to...). Limit dla niezweryfikowanej aplikacji to 100 połączonych kont.

Część B (każdy użytkownik): połącz swoje konto

  1. Otwórz Ustawienia → Profil → Kalendarz Google.
  2. Kliknij Połącz konto Google.
  3. Google zapyta, na które konto się zalogować - wybierz to, którego kalendarz chcesz widzieć (firmowe albo prywatne).
  4. Jeśli pojawi się ostrzeżenie „Google nie zweryfikował tej aplikacji" - kliknij Zaawansowane, potem Otwórz (to jednorazowe, patrz Część A).
  5. Zgódź się na dostęp do kalendarza (Zezwól / Allow).
  6. Wrócisz do Task Managera. Otwórz ponownie Ustawienia → Profil → Kalendarz Google - przy połączonym koncie pojawi się lista Twoich kalendarzy.
  7. Wybierz kalendarz i kliknij Importuj. Po chwili wydarzenia będą w Kalendarzu Task Managera.

Chcesz też drugi kalendarz (np. prywatny)? Wróć do tej samej sekcji i jeszcze raz kliknij Połącz konto Google - tym razem zaloguj się na drugie konto. Każde połączenie to osobna karta na liście, z własnym kalendarzem i przyciskiem Rozłącz.

Import obejmuje okno od 30 dni wstecz do roku w przód - zmienisz je w polach „Okno" przy każdym połączeniu.

Część C (zaawansowane): prywatny kalendarz przez własną przepustkę

Kiedy to potrzebne? Głównie gdy firmowa przepustka ma typ Wewnętrzny (Internal) - wtedy Google nie wpuści Twojego prywatnego Gmaila. Możesz wtedy założyć własną przepustkę na swoim prywatnym koncie Google i połączyć się przez nią:

  1. Przejdź całą Część A na swoim prywatnym koncie Google (własny projekt, typ Zewnętrzny, publikacja, własny Client ID i Secret). W kroku 4.5 wklej adres przekierowania pokazany w sekcji poniżej.
  2. W Task Managerze otwórz Ustawienia → Profil → Kalendarz Google i rozwiń Połącz z własnymi poświadczeniami (zaawansowane).
  3. Tam znajdziesz adres przekierowania (do kroku 4.5) oraz pola Client ID i Client Secret - wklej swoje i kliknij Połącz z własnymi poświadczeniami.
  4. Dalej jak w Części B: logowanie, zgoda, wybór kalendarza, Importuj.

Twoje poświadczenia są zapisywane zaszyfrowane i używane tylko dla tego jednego połączenia. Administrator nie musi nic robić.

Jak wydarzenia z Google zachowują się w Task Managerze

  • W Kalendarzu mają kolory z Google: kolor nadany wydarzeniu, a gdy go nie ma - kolor wybranego kalendarza (bardzo jasne kolory są delikatnie przyciemniane dla czytelności). Wydarzenia wysyłane z Task Managera do Google dostają najbliższy kolor z palety Google - kolory są przybliżone, bo palety obu aplikacji się różnią. Po kliknięciu okno edycji mówi wprost „Wydarzenie z Google" (z odnośnikiem do otwarcia w Google).
  • Edytujesz je jak każde inne wydarzenie: przeciąganie na inny termin, zmiana godzin i treści, usunięcie. Każda taka zmiana zapisuje się także w Kalendarzu Google - a zmiany zrobione w Google przychodzą do Task Managera same, co kilka minut.
  • Nie chcesz czekać? Kliknij ikonę synchronizacji (dwie strzałki w kółko) na górnym pasku okna Kalendarza. Pojawia się tylko wtedy, gdy masz podłączony Kalendarz Google, i ściąga zmiany od razu - przydaje się, gdy właśnie coś przestawiłeś w Google i chcesz to zobaczyć u siebie w tej chwili. Po zakończeniu komunikat mówi, ile wydarzeń doszło, zmieniło się i zniknęło. Ten sam przycisk („Synchronizuj teraz") jest przy połączeniu w Ustawieniach → Profil → Kalendarz Google.
  • Gdy ostatnia automatyczna synchronizacja się nie powiodła, ikona robi się pomarańczowa, a po najechaniu pokazuje powód. Kliknięcie ponawia próbę.
  • Nowe wydarzenia utworzone w Task Managerze też trafiają do Google: po wybraniu kalendarza włącza się opcja „Nowe wydarzenia z Task Managera dodawaj do tego kalendarza" (widoczna przy połączeniu w Ustawieniach). Włączenie dosyła od razu także przyszłe wydarzenia, które jeszcze nie były wysłane. Przy kilku połączeniach eksport działa na jedno wybrane - zaznaczenie na innym koncie przełącza cel. Wyeksportowane wydarzenie zachowuje swój kolor i synchronizuje się dalej w obie strony (usunięcie w Google usunie je też u Ciebie).
  • Usunięcie wydarzenia usuwa je również w Google (okno edycji mówi to wprost); „Cofnij" na pasku przywraca wydarzenie po obu stronach.
  • Kliknięcie otwiera zwykłe okno edycji z odnośnikiem otwórz w Google.
  • Przyszłe wydarzenia przypominają o sobie jak zwykłe wydarzenia Task Managera (powiadomienie o godzinie rozpoczęcia); przeszłe wchodzą cicho, do historii dnia.
  • Wydarzenia całodniowe pokazują się od 8:00 (wielodniowe - do 18:00 ostatniego dnia) i pozostają całodniowe w Google po przesunięciu na inny dzień.
  • Rozłącz (przy konkretnym połączeniu) usuwa z Twojego kalendarza wydarzenia zaimportowane z tego konta - w Google nic nie znika. Pozostałe połączenia działają dalej.

Usuwanie danych konta Google

  • Rozłączenie jednego konta: Ustawienia → Profil → Kalendarz Google → Rozłącz przy wybranym połączeniu. Znikają tokeny i zaimportowane wydarzenia z Twojego kalendarza (w Google nic się nie zmienia); pozostałe połączenia działają dalej.
  • Usunięcie poświadczeń instancji (administrator): Ustawienia → Zaawansowane → Kalendarz Google (OAuth) → Usuń poświadczenia. Kasuje Client ID i Client Secret oraz rozłącza wszystkich użytkowników połączonych przez te poświadczenia (ich zaimportowane wydarzenia znikają z Task Managera; w Google nic się nie zmienia). Połączenia z własnymi poświadczeniami (Część C) zostają nietknięte.
  • Dostęp aplikacji do konta Google możesz też zawsze cofnąć po stronie Google: myaccount.google.com → Bezpieczeństwo → Połączenia z aplikacjami innych firm.

Rozwiązywanie problemów

  • „Administrator nie skonfigurował jeszcze poświadczeń" - Część A nie została wykonana (albo możesz użyć własnych poświadczeń - Część C).
  • Google pisze „Nie masz dostępu" przy prywatnym koncie - firmowa przepustka ma typ Wewnętrzny; użyj Części C.
  • Błąd „połącz konto ponownie" - Google unieważnił dostęp (np. zmiana hasła, cofnięcie zgody na koncie Google albo aplikacja została w trybie testowym - patrz Część A, krok 3.5). Rozłącz i połącz konto od nowa.
  • Błąd „redirect_uri_mismatch" przy łączeniu - adres przekierowania w Google Cloud różni się od tego, który pokazuje Task Manager (Część A, krok 4.5). Popraw go w Google Cloud (Dane logowania → Twój klient OAuth).
  • Synchronizacja odbywa się, gdy ktokolwiek korzysta z aplikacji (wbudowany harmonogram); po dłuższej przerwie pierwszy sync nastąpi chwilę po otwarciu.
  • Zmiana z Google nie przyszła, choć minęło kilka minut? Kliknij ikonę synchronizacji na pasku Kalendarza - dostaniesz albo liczbę pobranych zmian, albo konkretny powód niepowodzenia. Stan ostatniego przebiegu (data i ewentualny błąd) widać też w Ustawieniach → Profil → Kalendarz Google.