Google-szolgáltatások csatlakoztatása (Tasks, Gmail, Drive, Névjegyek, Űrlapok, YouTube, Térkép)
Ez az útmutató a Google-szolgáltatások kapcsolatainak beállítását írja le. Az API-kapuban ezek a kész Google-adapterek vannak:
- Google Tasks: teendők felolvasása, felvitele, készre jelölése.
- Gmail: levelek keresése és felolvasása, piszkozat, küldés és válasz, olvasottnak jelölés, archiválás, kukába helyezés.
- Google Drive: fájlok keresése, Google-dokumentumok, -táblázatok, -diák, Word-dokumentumok és szövegfájlok felolvasása, új dokumentum diktált szövegből, új mappa, átnevezés, áthelyezés, kukába helyezés.
- Google Névjegyek: névjegyek keresése (az „Egyéb névjegyek” között is), egy névjegy adatai, új névjegy, módosítás (például új telefonszám), törlés.
- Google Űrlapok: a saját űrlapok listája, egy űrlap kérdései, a beérkezett kitöltések kérdésenként, új űrlap és új kérdés.
- YouTube: videók keresése és adatai, saját lejátszási listák és feliratkozások, új lista, videó hozzáadása egy listához.
- Google Térkép: helyek és címek keresése, közeli helyek, nyitvatartás és akadálymentességi adatok, útvonaltervezés gyalog, tömegközlekedéssel, autóval vagy kerékpárral.
A Google Térkép kivételével mind Google-fiókkal (OAuth 2.0) csatlakozik, ugyanazzal a Google Cloud projekttel és OAuth-klienssel. A Google Térképhez API-kulcs kell (lásd: Google Térkép). A Google Cloud Console angol nyelvű; a menüpontok angol nevét vastagon, a magyar jelentését zárójelben adjuk meg. A feliratok idővel változhatnak (ez a leírás 2026. októberi állapotot követ).
Hivatalos megoldás is van: a Gmailhez, a Google Naptárhoz és a Google Drive-hoz a Claude-nak saját, hivatalos csatlakozója van. Az API-kapus kapcsolat akkor hasznos, ha ugyanazt a ChatGPT-ből is el szeretné érni, ugyanazokkal az engedélyszintekkel, vagy ha a szolgáltatásnak nincs hivatalos csatlakozója (Névjegyek, Űrlapok, YouTube, Tasks).
Áttekintés
A beállítás három részből áll:
- A Google Cloud Console-ban egyszer létre kell hozni egy saját „alkalmazást” (OAuth-klienst). Ez kb. 15 perc, és csak egyszer kell elvégezni. Ha a Google Tasks kapcsolathoz ezt már megtette, csak a további API-kat kell bekapcsolnia, és a hozzáférési köröket kell bővítenie.
- Az API-kapuban fel kell venni a kapcsolatot (szolgáltatásonként egyet), és be kell jelentkezni a Google-fiókba. Minden Google-kapcsolatnál külön kell bejelentkezni, mert mindegyik csak a saját szolgáltatásához kap hozzáférést.
- Be kell kapcsolni a jogosultságokat: mit tehet a Claude és a ChatGPT az adott szolgáltatás adataival.
A Google-jelszó soha nem kerül az API-kapuhoz. A Google csak egy visszavonható hozzáférési engedélyt (tokent) ad, amelyet az API-kapu titkosítva tárol, és az AI soha nem lát.
A visszairányítási cím
Ezt a címet kell majd a Google Cloud Console-ba beírni, pontosan így:
https://api-kapu.hu/oauth/google/callback
1. rész: a Google Cloud Console beállítása
Projekt létrehozása
- Nyissa meg a console.cloud.google.com oldalt, és jelentkezzen be azzal a Google-fiókkal, amelynek a feladatait használni szeretné.
- Ha először jár itt, fogadja el a felhasználási feltételeket (Terms of Service).
- A lap tetején lévő projektválasztó gombbal (felirata Select a project, vagy egy meglévő projekt neve) nyissa meg a projektlistát, és válassza a New project (Új projekt) lehetőséget.
- A Project name (Projekt neve) mezőbe írja be: API-kapu. A többi mezőt hagyja változatlanul, és nyomja meg a Create (Létrehozás) gombot.
- A létrehozás után ellenőrizze, hogy a lap tetején az API-kapu projekt van-e kiválasztva. Ha nem, válassza ki a projektválasztóval.
A szükséges API-k bekapcsolása
Minden szolgáltatáshoz a saját API-ját kell bekapcsolni. Csak azokat kapcsolja be, amelyeket használni fog:
- Google Tasks: Google Tasks API
- Gmail: Gmail API
- Google Drive: Google Drive API
- Google Névjegyek: People API
- Google Űrlapok: Google Forms API és Google Drive API (az űrlapok listájához)
- YouTube: YouTube Data API v3
- Google Térkép: Places API (New) és Routes API (ehhez számlázási fiók is kell, lásd lent)
Egy API bekapcsolása:
- A keresőmezőbe (felirata Search) írja be az API nevét, például: Gmail API, és válassza ki a találatot (a Marketplace vagy APIs & Services alatt).
- Nyomja meg az Enable (Engedélyezés) gombot.
- Ismételje meg a többi API-val.
Az alkalmazás adatai (Google Auth Platform)
- A keresőmezőbe írja be: Google Auth Platform, és nyissa meg. (Régebbi néven: OAuth consent screen, magyarul hozzájárulási képernyő.)
- Nyomja meg a Get started (Kezdés) gombot.
- App information (Az alkalmazás adatai): az App name (Alkalmazás neve) legyen API-kapu, a User support email (Ügyfélszolgálati e-mail) listában válassza ki a saját e-mail-címét. Nyomja meg a Next (Tovább) gombot.
- Audience (Közönség): válassza az External (Külső) lehetőséget, majd Next.
- Contact information (Elérhetőség): írja be a saját e-mail-címét, majd Next.
- Finish (Befejezés): jelölje be, hogy elfogadja a Google API-szabályzatát, majd nyomja meg a Continue (Folytatás), végül a Create (Létrehozás) gombot.
Közzététel: ez fontos!
Az új alkalmazás „tesztelés” (Testing) állapotban indul. Ebben az állapotban a Google által adott engedély 7 nap után lejár, és újra be kellene jelentkezni. Ezért tegye közzé:
- A Google Auth Platform bal oldali menüjében válassza az Audience (Közönség) pontot.
- A Publishing status (Közzétételi állapot) résznél nyomja meg a Publish app (Alkalmazás közzététele) gombot, majd erősítse meg a Confirm (Megerősítés) gombbal.
- Az állapot ezután In production (Éles).
Az alkalmazást a Google nem ellenőrizte, de saját használatra ez nem akadály: bejelentkezéskor egy figyelmeztetést kell továbbléptetni (lásd lent). Ellenőrzés nélkül legfeljebb 100 felhasználó használhatja, ami saját használatra bőven elég.
A hozzáférési körök megadása (ajánlott)
- A bal oldali menüben válassza a Data Access (Adathozzáférés) pontot.
- Nyomja meg az Add or remove scopes (Hatókörök hozzáadása vagy eltávolítása) gombot.
- A lista alján lévő Manually add scopes (Hatókörök kézi hozzáadása) mezőbe másolja be a használt szolgáltatások sorait (soronként egyet), majd nyomja meg az Add to table (Hozzáadás a táblázathoz) gombot:
- Google Tasks: https://www.googleapis.com/auth/tasks
- Gmail: https://www.googleapis.com/auth/gmail.modify
- Google Drive: https://www.googleapis.com/auth/drive
- Google Névjegyek: https://www.googleapis.com/auth/contacts és https://www.googleapis.com/auth/contacts.other.readonly
- Google Űrlapok: https://www.googleapis.com/auth/forms.body, https://www.googleapis.com/auth/forms.responses.readonly és https://www.googleapis.com/auth/drive.metadata.readonly
- YouTube: https://www.googleapis.com/auth/youtube
- Nyomja meg az Update (Frissítés), majd a lap alján a Save (Mentés) gombot.
Csak olvasási hozzáféréshez az API-kapu a fenti körök „readonly” (csak olvasás) változatát kéri; ezeket nem kell külön felvenni. A Gmail és a Drive köreit a Google „korlátozott” (restricted) körnek tekinti. Saját, nem ellenőrzött alkalmazásnál ez nem akadály: bejelentkezéskor ugyanaz a figyelmeztetés jelenik meg, mint a többinél.
Az OAuth-kliens létrehozása
- A bal oldali menüben válassza a Clients (Kliensek) pontot, majd a Create client (Kliens létrehozása) gombot.
- Az Application type (Alkalmazás típusa) listában válassza a Web application (Webalkalmazás) lehetőséget.
- A Name (Név) mezőbe írja be: API-kapu.
- Az Authorized redirect URIs (Engedélyezett átirányítási URI-k) résznél nyomja meg az Add URI (URI hozzáadása) gombot, és írja be a fenti visszairányítási címet. Az Authorized JavaScript origins részt hagyja üresen.
- Nyomja meg a Create (Létrehozás) gombot.
- Megjelenik a Client ID (Ügyfél-azonosító) és a Client secret (Ügyfél titkos kulcsa). A titkos kulcsot a Google később nem mutatja meg újra, ezért most másolja ki mindkettőt (például egy jelszókezelőbe), vagy töltse le a Download JSON gombbal.
2. rész: a kapcsolat felvétele az API-kapuban
Az alábbi lépéseket minden Google-szolgáltatásnál el kell végezni (a Google Térkép kivételével, annak leírása lent).
- Az API-kapuban válassza az Új kapcsolat menüpontot.
- A kész adapterek között keresse meg a szolgáltatás adapterét (például „Gmail – levelek keresése, felolvasása, piszkozat és küldés”), és válassza a Felvétel ezzel az adapterrel hivatkozást.
- A kapcsolat nevét hagyhatja, majd nyomja meg a Kapcsolat mentése gombot. API-kulcsot nem kell megadni.
- A program a kapcsolat Google-fiók oldalára visz. Ide később a kapcsolatok listájából, a kapcsolat Google-fiók hivatkozásával juthat vissza.
- 1. lépés: másolja be a Client ID-t az Ügyfél-azonosító mezőbe, a Client secretet az Ügyfél titkos kulcsa mezőbe, és nyomja meg az OAuth-kliens adatainak mentése gombot. Ezt csak egyszer kell megtenni; minden további Google-kapcsolat ezt használja, ott ez a lépés már kész.
- 2. lépés: válassza ki a hozzáférést. Ha adatot is fel szeretne vinni vagy módosítani (teendő, piszkozat, névjegy), az Olvasás és írás kell. Ha csak felolvasásra használja (például a Gmailt), a Csak olvasás a biztonságosabb. Nyomja meg a Csatlakozás Google-fiókkal gombot.
- Megnyílik a Google bejelentkezési oldala. Válassza ki a fiókját.
- Megjelenik a figyelmeztetés: Google hasn't verified this app (A Google nem ellenőrizte ezt az alkalmazást). Válassza az Advanced (Speciális), majd a Go to API-kapu (unsafe) (Ugrás az API-kapu oldalra, nem biztonságos) hivatkozást. Ez a saját alkalmazása, ezért ez rendben van.
- A Google felsorolja, mihez kér hozzáférést. Ha a sorok mellett jelölőnégyzet van, jelölje be mindet (vagy a Select all, azaz Az összes kiválasztása lehetőséget), különben a hozzáférés nem jön létre. Végül nyomja meg a Continue (Folytatás) gombot.
- A Google visszavisz az API-kapu Google-fiók oldalára. A program magától lefuttat egy kapcsolattesztet (például a Gmailnél a postafiók adatait, a Drive-nál a tárhely adatait kéri le), és az eredményt felolvasható üzenetben jelzi. Siker esetén a kapcsolat állapota „Használható”.
3. rész: jogosultságok
Biztonsági okból egy új kapcsolatnál csak az olvasás engedélyezett. Felvitelhez vagy módosításhoz:
- A kapcsolatok listájában válassza a kapcsolat Szerkesztés hivatkozását.
- Az Engedélyezett műveletek csoportban jelölje be, amire szükség van, és mentse a kapcsolatot:
- Új adatok létrehozása: új teendő, Gmail-piszkozat és levélküldés, új Drive-dokumentum és mappa, új névjegy, új űrlap, új lejátszási lista.
- Meglévő adatok módosítása: teendő készre jelölése, levél olvasottnak jelölése vagy archiválása, fájl átnevezése, névjegy módosítása, új kérdés egy űrlapon.
- Adatok törlése: teendő vagy névjegy törlése, levél vagy fájl kukába helyezése. Ezt csak akkor kapcsolja be, ha valóban szüksége van rá.
- Az AI-kliensek menüben nyissa meg a Claude-ot, jelölje be ugyanezeket a kapcsolatnál, és mentse. Ugyanígy a ChatGPT-nél is.
Figyelem: a Gmailnél a levélküldés az „Új adatok létrehozása” engedélyhez tartozik, a piszkozattal együtt. Ha azt szeretné, hogy az AI csak piszkozatot készíthessen, de levelet ne küldhessen, a kapcsolat Műveletek oldalán a „Levél küldése vagy megválaszolása” műveletnél vegye ki a jóváhagyást. 4. Kezdjen új beszélgetést. A ChatGPT-ben szükség lehet az API-kapu alkalmazás frissítésére a beállításokban, hogy az új eszközöket lássa.
Google Térkép (API-kulccsal)
A Google Térkép nem Google-fiókkal, hanem API-kulccsal csatlakozik. Fizetős szolgáltatás, havi ingyenes kerettel: magánhasználatra ez általában elég, de a Google csak akkor engedi, ha a projekthez számlázási fiók (bankkártya) tartozik.
- A Google Cloud Console bal oldali menüjében (vagy a keresőben) válassza a Billing (Számlázás) pontot, és rendeljen számlázási fiókot az API-kapu projekthez. Ajánlott a Budgets & alerts (Költségkeretek és riasztások) résznél egy alacsony havi keretet és e-mailes riasztást beállítani.
- Kapcsolja be a Places API (New) és a Routes API szolgáltatást (lásd: A szükséges API-k bekapcsolása).
- A keresőben nyissa meg a Credentials (Hitelesítő adatok) oldalt, nyomja meg a Create credentials (Hitelesítő adatok létrehozása) gombot, és válassza az API key (API-kulcs) lehetőséget.
- A létrejött kulcsnál válassza az Edit API key (API-kulcs szerkesztése) lehetőséget. Az API restrictions (API-korlátozások) résznél válassza a Restrict key (Kulcs korlátozása) lehetőséget, és jelölje be a Places API (New) és a Routes API szolgáltatást. Mentse (Save).
- Másolja ki a kulcsot.
- Az API-kapuban válassza az Új kapcsolat menüpontot, majd a „Google Térkép – helyek, nyitvatartás, útvonaltervezés” adaptert. Az API-kulcs mezőbe másolja be a kulcsot, és mentse a kapcsolatot. Utána futtassa a kapcsolattesztet.
Példák: „Hol van a legközelebbi nyitva tartó gyógyszertár a Kadosa utca 59-hez?”, „Mikor van nyitva a Budai Központi Kerületi Bíróság?”, „Hogyan jutok el gyalog a Szentlélek térre a Kadosa utcától, lépésenként?”. Budapesti tömegközlekedéshez a BKK FUTÁR kapcsolat pontosabb.
Használat
Példák:
- Teendők: „Mik a mai teendőim?”, „Vegyél fel egy teendőt holnapra: felhívni Kovács urat.”, „Jelöld késznek a szerződés-előkészítést.”
- Gmail: „Milyen olvasatlan leveleim jöttek ma?”, „Olvasd fel Kovács Béla legutóbbi levelét.”, „Készíts választ erre a levélre: köszönöm, jövő héten jelentkezem.”
- Drive: „Keresd meg a Szabó András adásvételi szerződését a Drive-ban, és olvasd fel.”, „Hozz létre egy feljegyzést a mai ügyfélhívásról ezzel a szöveggel: …”
- Névjegyek: „Mi Szegedi József telefonszáma?”, „Vedd fel Horváth Imre új mobilszámát: …”
- Űrlapok: „Jött új kitöltés az ügyfél-adatlapra a héten? Olvasd fel.”
- YouTube: „Keress videót a társasházi törvény módosításáról.”, „Tedd be az első találatot a Jog lejátszási listámba.”
A Google Tasks alapértelmezett feladatlistájának neve a műveletekben @default; ha több listája van, az AI előbb lekéri a listákat. A Google Tasks a határidőnél csak a napot tárolja, időpontot nem. Felvitel, módosítás, küldés és törlés előtt az AI elmondja, mit fog tenni.
A levelek, dokumentumok, névjegyek és kitöltések tartalma a beszélgetésbe kerül, vagyis az AI-szolgáltató (Anthropic vagy OpenAI) is feldolgozza. Ügyféladatoknál ezt az adatkezelési tájékoztatóban érdemes figyelembe venni.
Leválasztás
A kapcsolat Google-fiók oldalán a Google-fiók leválasztása gomb törli a tárolt engedélyt, és a Google-nál is visszavonja. A hozzáférés a Google-fiók biztonsági beállításainál (Harmadik féltől származó alkalmazások és szolgáltatások) is visszavonható; ilyenkor az API-kapu a következő kéréskor jelzi, hogy újra kell csatlakoztatni.
Ha valami nem működik
- „redirect_uri_mismatch” vagy „Hiba 400” a Google-oldalon: a Google Cloud Console-ban megadott visszairányítási cím nem egyezik a fenti címmel. Ellenőrizze betűre pontosan (https, www, perjel a végén nincs).
- „Hozzáférés letiltva: az API-kapu nem fejezte be a Google ellenőrzési folyamatát”: az alkalmazás még tesztelési állapotban van. Tegye közzé (lásd: Közzététel), vagy az Audience oldalon a Test users (Tesztfelhasználók) közé vegye fel a saját e-mail-címét.
- „A Google-fiók csatlakoztatásakor adott engedély ehhez a művelethez nem elég”: csak olvasásra csatlakozott, vagy a Google-oldalon nem jelölte be a feladatokhoz tartozó négyzetet. Csatlakozzon újra Olvasás és írás hozzáféréssel.
- „A Google nem fogadta el az OAuth-kliens adatait”: a Client ID vagy a Client secret hibás. Az 1. lépésben adja meg újra; ha a titkos kulcs elveszett, a Google Cloud Console-ban a kliensnél új titkos kulcs kérhető (Add secret).
- „A Google Cloud projektben nincs bekapcsolva ez az API”: kapcsolja be a szolgáltatás API-ját (lásd: A szükséges API-k bekapcsolása). A bekapcsolás után néhány perc is eltelhet, mire működik.
- Google Térkép: „A Google nem fogadta el az API-kulcsot” vagy „nincs beállítva számlázási fiók”: ellenőrizze a kulcsot (Kulcs cseréje), a számlázási fiókot és azt, hogy a kulcs korlátozásai között szerepel-e a Places API (New) és a Routes API.
- YouTube: „Elfogyott a szolgáltatás napi kerete”: a YouTube napi kerete 10 000 egység, egy keresés 100 egység. Másnap reggel újra működik.
- Névjegyek: az első keresés nem talál semmit: az API-kapu a Google előírása szerint előbb egy üres „bemelegítő” keresést küld; ha mégis üres a találat, próbálja újra, vagy keressen az „Egyéb névjegyek” között.
- Egy hét után megszűnik a hozzáférés: az alkalmazás tesztelési állapotban maradt. Tegye közzé, majd csatlakoztassa újra a fiókot.
- A Claude vagy a ChatGPT nem tud adatot felvinni, csak olvasni: a felvitelt a kapcsolatnál és az AI-kliens jogosultságainál is be kell kapcsolni (3. rész), és a Google-fiókot „Olvasás és írás” hozzáféréssel kell csatlakoztatni.