A Task Manager meg tudja jeleníteni a Google Naptáradból származó eseményeket a saját Naptárában, és mindkét irányban szinkronizálni tudja azokat: a Google-ban végzett módosítás magától megjelenik a Task Managerben (néhány percenként), a Task Managerben végzett módosítás pedig azonnal elmentődik a Google-ba. A Google-ból származó eseményeket kizárólag Te látod - a kapcsolat személyes, mint egy postafiók.

Egyszerre több fiókot is összekapcsolhatsz - például a céges naptárat és a saját privát naptáradat. Minden kapcsolatnak saját naptára van, és egymástól függetlenül működik.

Az útmutató három részből áll:

  • A rész - az adminisztrátornak, egyszeri alkalommal: „belépő" létrehozása a Google-ban (enélkül senki nem tudja összekapcsolni a fiókját).
  • B rész - minden felhasználónak: hogyan kapcsold össze a saját Google-fiókodat.
  • C rész - az érdeklődőknek: privát naptár saját „belépővel" (csak különleges esetekben szükséges).

A rész (adminisztrátor, egyszeri alkalommal): belépő a Google-ban

A Google megköveteli, hogy minden, a naptárhoz kapcsolódó alkalmazásnak legyen saját „belépője" - az úgynevezett OAuth hitelesítő adatok (két hosszú karakterlánc: Client ID és Client Secret). Ezeket egyszer, ingyenesen hozod létre a Google Cloud konzolon. Ez kb. 10 percet vesz igénybe. Sorban:

1. lépés. Hozz létre egy projektet

  1. Lépj be a console.cloud.google.com oldalra, és jelentkezz be egy Google-fiókkal (lehetőleg céges fiókkal).
  2. Az oldal tetején kattints a projektlistára, és válaszd az Új projekt (New project) lehetőséget.
  3. Nevezd el pl. Task Manager-nek, kattints a Létrehozás (Create) gombra, és várj egy kicsit, amíg a Google létrehozza. Győződj meg róla, hogy ki van választva (a neve fent látható).

2. lépés. Kapcsold be a Google Calendar API-t

  1. A bal oldali menüben válaszd az API-k és szolgáltatások → Könyvtár (APIs & Services → Library) lehetőséget.
  2. A keresőbe írd be: Google Calendar API, kattints a találatra, majd a Engedélyezés (Enable) gombra.

3. lépés. Állítsd be a hozzájárulási képernyőt

Ez az az ablak, amelyet a felhasználók a fiók összekapcsolásakor látnak majd („Az X alkalmazás hozzáférést kér a naptárhoz").

  1. A bal oldali menüben válaszd az API-k és szolgáltatások → OAuth hozzájárulási képernyő (OAuth consent screen) lehetőséget. A konzol újabb verziójában ez a szekció Google hitelesítési platform (Google Auth Platform) néven szerepel - ekkor kattints a Kezdés (Get started) gombra.
  2. Add meg az alkalmazás nevét (pl. Task Manager) és a kapcsolattartási e-mail-címedet.
  3. Címzett típusa (User type / Audience):
    • Belső (Internal) - csak akkor, ha a cég Google Workspace-t használ. A legkényelmesebb: nincsenek figyelmeztetések, de csak a cég domainjéhez tartozó fiókok csatlakozhatnak (a privát Gmail nem fog csatlakozni - lásd a C részt).
    • Külső (External) - minden más esetben. Bármilyen Google-fiókkal működik.
  4. Mentés / Létrehozás.
  5. Fontos Külső típus esetén: az Audience szekcióban kattints az Alkalmazás közzététele (Publish app) gombra, hogy az állapot „Tesztelés"-ről „Éles verzióban"-ra (In production) váltson. Tesztmódban a Google minden résztvevőt 7 naponta leválaszt, és újra kell csatlakozni.

4. lépés. Hozd létre az OAuth klienst (vagyis a tényleges belépőt)

  1. A bal oldali menüben válaszd az API-k és szolgáltatások → Hitelesítő adatok (Credentials) lehetőséget - vagy Kliensek (Clients) az új konzolban.
  2. Kattints a Hitelesítő adatok létrehozása → OAuth kliensazonosító (Create credentials → OAuth client ID) gombra.
  3. Alkalmazástípus: Webalkalmazás (Web application).
  4. Név: pl. Task Manager.
  5. Most a legfontosabb mező: Engedélyezett átirányítási URI-k (Authorized redirect URIs). Kattints URI hozzáadása és illeszd be PONTOSAN azt a címet, amelyet a Task Manager mutat itt: Beállítások → Speciális → Google Naptár (OAuth) - a vége: /api/gcal/oauth-callback.
    • Figyelem: NE illeszd be ezt a címet az „Engedélyezett JavaScript-eredetek" (Authorized JavaScript origins) mezőbe - ez egy másik mező, hibát fog jelezni. Hagyd üresen.
  6. Kattints a Létrehozás gombra. A Google megmutatja a Kliensazonosítót (Client ID, .apps.googleusercontent.com-ra végződik) és a Kliens titkos kulcsát (Client Secret, GOCSPX--vel kezdődik). Másold ki mindkettőt.

5. lépés. Illeszd be a belépőt a Task Managerbe

  1. A Task Managerben nyisd meg a Beállítások → Speciális → Google Naptár (OAuth) menüt.
  2. Illeszd be a Client ID-t és a Client Secret-et, kattints a Mentés gombra.

Kész - mostantól minden felhasználó összekapcsolhatja a saját fiókját (B rész).

Külső típus esetén a Google a kapcsolódáskor egyszeri „A Google nem ellenőrizte ezt az alkalmazást" figyelmeztetést mutatja. Ez normális a céges alkalmazásoknál - kattints a Speciális (Advanced), majd a Ugrás: <név> (Go to...) lehetőségre. A nem ellenőrzött alkalmazás korlátja 100 összekapcsolt fiók.

B rész (minden felhasználó): kapcsold össze a fiókodat

  1. Nyisd meg a Beállítások → Profil → Google Naptár menüt.
  2. Kattints a Google-fiók összekapcsolása gombra.
  3. A Google megkérdezi, melyik fiókkal szeretnél bejelentkezni - válaszd azt, amelyiknek a naptárát látni szeretnéd (céges vagy privát).
  4. Ha megjelenik a „A Google nem ellenőrizte ezt az alkalmazást" figyelmeztetés - kattints a Speciális, majd az Ugrás gombra (ez egyszeri, lásd A rész).
  5. Fogadd el a naptárhoz való hozzáférést (Engedélyezés / Allow).
  6. Visszakerülsz a Task Managerbe. Nyisd meg újra a Beállítások → Profil → Google Naptár menüt - az összekapcsolt fióknál megjelenik a naptáraid listája.
  7. Válaszd ki a naptárat, és kattints az Importálás gombra. Egy pillanat múlva az események megjelennek a Task Manager Naptárában.

Szeretnél egy második naptárat is (pl. privátot)? Térj vissza ugyanahhoz a szekcióhoz, és kattints ismét a Google-fiók összekapcsolása gombra - ezúttal jelentkezz be a második fiókkal. Minden kapcsolat külön kártya a listán, saját naptárral és Leválasztás gombbal.

Az importálás 30 nappal visszamenőleg egy évvel előre tartó időablakot fed le - ezt a „Ablak" mezőkben módosíthatod minden kapcsolatnál.

C rész (haladó): privát naptár saját belépővel

Mikor van erre szükség? Főleg akkor, ha a céges belépő Belső (Internal) típusú - ekkor a Google nem engedi be a privát Gmail-fiókodat. Ilyenkor létrehozhatsz saját belépőt a privát Google-fiókodban, és azon keresztül kapcsolódhatsz:

  1. Végezd el a teljes A részt a saját privát Google-fiókodban (saját projekt, Külső típus, közzététel, saját Client ID és Secret). A 4.5 lépésben illeszd be az alábbi szekcióban mutatott átirányítási címet.
  2. A Task Managerben nyisd meg a Beállítások → Profil → Google Naptár menüt, és nyisd le a Kapcsolódás saját hitelesítő adatokkal (haladó) részt.
  3. Ott találod az átirányítási címet (a 4.5 lépéshez), valamint a Client ID és Client Secret mezőket - illeszd be a sajátjaidat, és kattints a Kapcsolódás saját hitelesítő adatokkal gombra.
  4. Ezután ugyanúgy, mint a B részben: bejelentkezés, hozzájárulás, naptárválasztás, Importálás.

A hitelesítő adataid titkosítva kerülnek mentésre, és kizárólag ehhez az egy kapcsolathoz kerülnek felhasználásra. Az adminisztrátornak nincs teendője.

Hogyan viselkednek a Google-eseményei a Task Managerben

  • A Naptárban Google-színeket kapnak: az eseményhez rendelt színt, ha pedig nincs ilyen - a kiválasztott naptár színét (a nagyon világos színeket a jobb olvashatóság érdekében kissé sötétítjük). A Task Managerből a Google-ba küldött események a Google palettájából a legközelebbi színt kapják - a színek közelítőek, mert a két alkalmazás palettája eltér. A rákattintás után a szerkesztőablak egyértelműen jelzi: „Esemény a Google-ból" (a Google-ban való megnyitáshoz vezető hivatkozással).
  • Ugyanúgy szerkesztheted, mint bármely más eseményt: áthúzhatod másik időpontra, módosíthatod az időpontokat és a tartalmat, törölheted. Minden ilyen változás a Google Naptárban is elmentődik - a Google-ban végzett módosítások pedig maguktól, néhány percenként érkeznek meg a Task Managerbe.
  • Nem szeretnél várni? Kattints a szinkronizálás ikonra (két nyíl körben) a Naptár ablak felső sávjában. Csak akkor jelenik meg, ha van összekapcsolt Google Naptárad, és azonnal lehúzza a változásokat - hasznos, ha épp most rendeztél át valamit a Google-ban, és azonnal szeretnéd látni magadnál. A befejezés után az üzenet megmondja, hány esemény érkezett, változott és tűnt el. Ugyanez a gomb („Szinkronizálás most") megtalálható a kapcsolatnál a Beállítások → Profil → Google Naptár menüben is.
  • Ha az utolsó automatikus szinkronizálás nem sikerült, az ikon narancssárga lesz, és az egérrel rámutatva megmutatja az okot. A rákattintás megismétli a próbálkozást.
  • A Task Managerben létrehozott új események is bekerülnek a Google-be: a naptár kiválasztása után bekapcsolható az „Új Task Manager-eseményeket adja hozzá ehhez a naptárhoz" opció (a kapcsolatnál látható a Beállításokban). A bekapcsolás azonnal elküldi a még el nem küldött jövőbeli eseményeket is. Több kapcsolat esetén az exportálás mindig egy kiválasztott kapcsolatra vonatkozik - a kijelölés egy másik fiókon átváltja a célt. Az exportált esemény megtartja a színét, és továbbra is mindkét irányban szinkronizálódik (a Google-ben történő törlés nálad is törli).
  • Az esemény törlése a Google-ben is törli azt (a szerkesztőablak ezt egyértelműen jelzi); a sávon található „Visszavonás" mindkét oldalon visszaállítja az eseményt.
  • A kattintás a szokásos szerkesztőablakot nyitja meg a Google-ben való megnyitás hivatkozással.
  • A jövőbeli események ugyanúgy emlékeztetnek magukra, mint a szokásos Task Manager-események (értesítés a kezdés időpontjában); a múltbeliek csendben kerülnek be a nap előzményeibe.
  • Az egész napos események 8:00-tól jelennek meg (a több napos események az utolsó nap 18:00-jáig), és más napra áthelyezve is egész naposak maradnak a Google-ben.
  • A Szétkapcsolás (egy adott kapcsolatnál) törli a naptáradból az adott fiókból importált eseményeket - a Google-ben semmi nem tűnik el. A többi kapcsolat tovább működik.

Google-fiók adatainak törlése

  • Egy fiók szétkapcsolása: Beállítások → Profil → Google Naptár → Szétkapcsolás a kiválasztott kapcsolatnál. Eltűnnek a tokenek és a naptáradba importált események (a Google-ben semmi nem változik); a többi kapcsolat tovább működik.
  • A rendszer hitelesítő adatainak törlése (rendszergazda): Beállítások → Speciális → Google Naptár (OAuth) → Hitelesítő adatok törlése. Törli a Client ID-t és a Client Secretet, és szétkapcsolja az összes, ezekkel a hitelesítő adatokkal csatlakoztatott felhasználót (az ő importált eseményeik eltűnnek a Task Managerből; a Google-ben semmi nem változik). A saját hitelesítő adatokkal létrehozott kapcsolatok (C rész) érintetlenek maradnak.
  • Az alkalmazás Google-fiókhoz való hozzáférését bármikor visszavonhatod a Google oldalán is: myaccount.google.com → Biztonság → Külső alkalmazások kapcsolatai.

Hibaelhárítás

  • „A rendszergazda még nem állította be a hitelesítő adatokat" - az A rész nem lett elvégezve (vagy használhatod a saját hitelesítő adataidat - C rész).
  • A Google „Nincs hozzáférésed" üzenetet ír ki magánfiók esetén - a céges alkalmazás típusa Belső; használd a C részt.
  • „Csatlakoztasd újra a fiókot" hiba - a Google érvénytelenítette a hozzáférést (pl. jelszóváltás, a hozzájárulás visszavonása a Google-fiókban, vagy az alkalmazás teszt módban maradt - lásd az A rész 3.5. lépését). Kapcsold szét, majd csatlakoztasd újra a fiókot.
  • „redirect_uri_mismatch" hiba a csatlakoztatáskor - a Google Cloudban megadott átirányítási cím eltér attól, amit a Task Manager mutat (A rész, 4.5. lépés). Javítsd ki a Google Cloudban (Hitelesítési adatok → OAuth-kliensed).
  • A szinkronizálás akkor történik, amikor bárki használja az alkalmazást (beépített ütemezés); hosszabb szünet után az első szinkronizálás röviddel a megnyitás után zajlik le.
  • Nem érkezett meg a Google-ből a változás, pedig eltelt néhány perc? Kattints a Naptár sávján lévő szinkronizálás ikonra - vagy megkapod a letöltött változtatások számát, vagy a konkrét hiba okát. Az utolsó futás állapota (dátum és az esetleges hiba) a Beállítások → Profil → Google Naptár alatt is látható.