Google Naptár: haladó beállítás saját Google-alkalmazással

A haladó beállításnál a Google Cloud Console-ban saját OAuth-hitelesítő adatokat hozol létre, és ezeket adod meg az Ameliában. Akkor érdemes ezt választani, ha teljes kontrollt szeretnél a hitelesítés, a megjelenés vagy a szervezeti Google-fiókok felett. A beállítás több lépés, de egyszeri: ha jól csinálod, utána megbízhatóan szinkronizál.

A Google „nincs ellenőrizve” figyelmeztetése

A haladó beállításnál a saját Google-alkalmazásodat hozod létre, tehát te vagy az integráció fejlesztője, nem az Amelia. Mivel az alkalmazás új és a Google nem ellenőrizte, a munkavállalók naptárának csatlakoztatásakor a Google kiírhatja, hogy az alkalmazást nem ellenőrizte. Ez várt üzenet, és nem akadályozza az integráció működését, csupán azt jelzi, hogy az alkalmazás nem ment át a Google nem kötelező ellenőrzésén. Nyugodtan folytathatod: válaszd a Speciális (Advanced) hivatkozást, majd az alkalmazásod megnevezésére kattints („Go to …”), hiszen a hitelesítő adatokat te hoztad létre.

Ha szeretnéd, benyújthatod az alkalmazást a Google ellenőrzésére is a Google Cloud Console-ban, de az Amelia normál működéséhez nem szükséges. Az ellenőrzés lépéseit lásd lejjebb.

A Google gyakran frissíti és átrendezi a Google Cloud Console felületét. A menük nevei és az útvonalak változhatnak, a beállítás lényegi lépései viszont ugyanazok maradnak.

Az Amelia előkészítése

A haladó beállítás előtt a szabványos Google-kapcsolat nem lehet aktív.

1. Ha korábban a Bejelentkezés a Google-lel módszert használtad, előbb szakítsd meg a kapcsolatot (Fiók leválasztása). Ez a módszer letiltja a Client ID és a Kliens titkos kulcsa mezőt, így kézzel nem lehetne kitölteni.
2. Nyisd meg a Funkciók és integrációk → Integrációk → Google-naptár és Google Meet → Beállítás oldalt, és válaszd az Általános lapot.

Itt fogod megadni a Google Cloud Console-ban létrehozott adatokat.

A kapcsolat létrejötte után a munkavállalók a Google Naptár beállításaiban leírt szabályok szerint csatlakoztathatják a naptáraikat: legfeljebb 6 Google-fiókot köthetnek be, 1 naptárat választhatnak az események létrehozásához, és legfeljebb 6 naptárat használhatnak a foglalt események ellenőrzésére és az elérhetőség lezárására. Ebben a beállításban a naptárkapcsolatokat a munkavállalók kezelik, az adminisztrátor nem rendel hozzájuk naptárat.

Mit kell beállítani a Google Cloud Console-ban?

A beállítás mindig ezekből a lépésekből áll, a felület változásaitól függetlenül:

1. Google Cloud-projekt létrehozása vagy kiválasztása. Új projektet is létrehozhatsz, vagy használhatsz egy meglévőt. A projekt tartalmazza az Amelia által használt API-kat és hitelesítő adatokat.
2. A Google Calendar API engedélyezése. Nélküle az Amelia nem tud eseményeket létrehozni és kezelni.
3. OAuth 2.0 hitelesítő adatok létrehozása webalkalmazáshoz. Ezekkel azonosítja magát az Amelia a Google felé.
4. Az Amelia átirányítási URI-jának megadása. A Google átirányítási címet kér a biztonságos engedélyezéshez. Másold ki az Átirányítási URI mező értékét az Amelia Google-beállításaiból, és illeszd be a Google Cloud Console OAuth-beállításába.
5. A Client ID és a Client secret másolása az Ameliába. A létrehozás után másold be őket az Általános lap megfelelő mezőibe.
6. Az alkalmazás közzététele. Az OAuth-alkalmazást közzé kell tenni, hogy a Google valódi felhasználóknak is engedélyezze a hitelesítést. A közzé nem tett alkalmazás csak tesztfelhasználókkal működik, vagy hibázik a munkavállalók csatlakoztatásakor.

Új Google Cloud-projekt létrehozása

1. Nyisd meg a Google Cloud Console-t.
2. Kattints a bal felső sarokban a projektválasztóra (a „Google Cloud” logó mellett), vagy nyomd meg a CTRL+O billentyűkombinációt.
3. A felugró ablak jobb felső sarkában kattints a NEW PROJECT gombra.
4. Válaszd a No Organisation lehetőséget, ha ingyenes Google-fiókot használsz, vagy a cégprofilodat, ha Google Workspace-t.
5. Add meg a projekt nevét (például „Amelia GCal Integration”), és kattints a CREATE gombra.

Üzleti fiókoknál mindenképp a cég szervezetét válaszd. Személyes fióknál a No Organisation az alapértelmezés.

A Google Calendar API engedélyezése

1. A projekt létrehozása után kattints a jobb felső értesítésben a Select Project gombra (vagy nyisd meg újra a projektválasztót CTRL+O-val, és válaszd ki az új projektet).
2. Nyisd meg a menüt (☰ a bal felső sarokban, vagy nyomd meg a „.” billentyűt).
3. Menj az APIs & Services → Library oldalra.
4. A keresőbe írd be: google calendar api.
5. Kattints a Google Calendar API találatra, majd az Enable gombra.

OAuth-hitelesítő adatok létrehozása

1. Az API engedélyezése után kattints a jobb felső sarokban a Create Credentials gombra. Másik módon: APIs & Services → Credentials, majd a képernyő közepén a + Create Credentials legördülőben válaszd az OAuth client ID lehetőséget.
2. Válaszd ki a Google Calendar API és a User Data lehetőséget, majd kattints a Next gombra.
3. Add meg az alkalmazás nevét (App name, például „Amelia GCal”).
4. A User support email és a Developer contact information mezőbe is a saját e-mail-címedet írd.
5. Kattints a Save and Continue gombra.

Az OAuth Client ID megadása

A következő lépésen (Scopes) ne módosíts semmit, hacsak nem akarod benyújtani az alkalmazást ellenőrzésre: kattints újra a Save and Continue gombra. Ezután az OAuth Client ID következik.

1. Az Application type mezőben válaszd a Web application típust.

2. Adj neki nevet (például „Amelia GCal”).

3. Görgess az Authorized redirect URIs részhez, kattints a + Add URI gombra, és illeszd be az Átirányítási URI-t az Ameliából (Funkciók és integrációk → Integrációk → Google-naptár és Google Meet → Beállítás → Általános). Például:

   https://sajatoldalad.hu/wp-admin/admin.php?page=wpamelia-employees

4. Ha a webhely előoldali munkavállalói felületét is használod, kattints újra a + Add URI gombra, és add hozzá a felület teljes címét is (például https://sajatoldalad.hu/munkatars-felulet/). A végén a perjel (/) is kell.

5. Kattints a Create gombra.

Fontos:

• Az Authorized redirect URIs részhez add hozzá a címet, ne az Authorized JavaScript origins részhez.
• A webhelyednek HTTPS-t kell használnia, a HTTP nem működik.
• Ne hagyd az alkalmazást Testing módban: ilyenkor a munkavállalók kapcsolata 1 vagy 2 naponta megszakad. Tedd közzé (Production).

Nem kötelező: az alkalmazás beküldése Google-ellenőrzésre

Ha el akarod tüntetni a „nincs ellenőrizve” figyelmeztetést a munkavállalók csatlakozásakor, benyújthatod az OAuth-alkalmazást a Google Cloud Console-ban ellenőrzésre. Az OAuth-hozzájárulási képernyőn ehhez ezt a két jogosultsági kört kell beállítani:

• /auth/calendar.readonly
• /auth/calendar.events

Az ellenőrzés nem automatikus, teljes egészében a Google végzi, és kérhet további információt arról, hogyan használja az alkalmazás a Google-adatokat. Az ellenőrzés nem kötelező: nélküle is minden normálisan működik, a Google csak figyelmeztetést jelenít meg az engedélyezéskor.

A Client ID és a Client Secret megszerzése

Amíg a hitelesítő adatok képernyőn vagy, másold ki a Client ID-t, és illeszd be az Ameliában a Funkciók és integrációk → Integrációk → Google-naptár és Google Meet → Beállítás → Általános lap Client ID mezőjébe, majd kattints a Done gombra a Google Cloud Console-ban.

Ha ezt a lépést kihagytad, a Client ID a titkos kulccsal együtt később is elérhető:

1. Nyisd meg a menüt (☰ vagy a „.” billentyű).
2. Menj az APIs & Services → Credentials oldalra.
3. Az OAuth 2.0 Client IDs alatt kattints az alkalmazásod nevére.
4. Jobbra látod a Client ID-t és az elrejtett Client secret értéket (kattints a másolás gombra).
5. Illeszd be mindkettőt az Amelia Általános lapjának Client ID és Kliens titkos kulcsa mezőjébe, majd kattints a Mentés gombra.

Az alkalmazás közzététele

1. Nyisd meg a menüt (☰ vagy a „.” billentyű).
2. Menj az APIs & Services → OAuth consent screen → Audience oldalra.
3. A Publishing Status alatt kattints a Publish app gombra.
4. A „Push to production?” kérdésnél hagyd jóvá.

Ezzel az Amelia össze van kötve a Google Cloud-dal.

Tudnivalók

• A haladó beállítás azoknak való, akiknek teljes kontrollra van szükségük az OAuth-hitelesítő adatok vagy a márkázott Google-engedélyező képernyők felett.
• Az átirányítási URI-nak pontosan egyeznie kell. Bármilyen eltérés megakadályozza a hitelesítést.
• A kapcsolat létrejötte után a munkavállalók a Google Naptár beállításainál leírt szabályok szerint kötik be a naptáraikat: legfeljebb 6 Google-fiók, 1 naptár az események létrehozásához és legfeljebb 6 naptár a foglalt események ellenőrzéséhez.
• A beállítás egyszeri. Nem kell megismételni, hacsak a hitelesítő adatokat vissza nem vonják, vagy a domain meg nem változik.
• A haladó beállítás localhoston nem működik, mert a Google nem engedi a http:// címet az átirányítási URI mezőkben. Localhoston a szabványos csatlakozást használd.