Ugrás a tartalomra

API-kapu

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:

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:

  1. 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.
  2. 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.
  3. 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

  1. Nyissa meg a console.cloud.google.com oldalt, és jelentkezzen be azzal a Google-fiókkal, amelynek a feladatait használni szeretné.
  2. Ha először jár itt, fogadja el a felhasználási feltételeket (Terms of Service).
  3. 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.
  4. 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.
  5. 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:

Egy API bekapcsolása:

  1. 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).
  2. Nyomja meg az Enable (Engedélyezés) gombot.
  3. Ismételje meg a többi API-val.

Az alkalmazás adatai (Google Auth Platform)

  1. 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ő.)
  2. Nyomja meg a Get started (Kezdés) gombot.
  3. 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.
  4. Audience (Közönség): válassza az External (Külső) lehetőséget, majd Next.
  5. Contact information (Elérhetőség): írja be a saját e-mail-címét, majd Next.
  6. 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é:

  1. A Google Auth Platform bal oldali menüjében válassza az Audience (Közönség) pontot.
  2. 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.
  3. 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)

  1. A bal oldali menüben válassza a Data Access (Adathozzáférés) pontot.
  2. Nyomja meg az Add or remove scopes (Hatókörök hozzáadása vagy eltávolítása) gombot.
  3. 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
  4. 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

  1. A bal oldali menüben válassza a Clients (Kliensek) pontot, majd a Create client (Kliens létrehozása) gombot.
  2. Az Application type (Alkalmazás típusa) listában válassza a Web application (Webalkalmazás) lehetőséget.
  3. A Name (Név) mezőbe írja be: API-kapu.
  4. 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.
  5. Nyomja meg a Create (Létrehozás) gombot.
  6. 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).

  1. Az API-kapuban válassza az Új kapcsolat menüpontot.
  2. 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.
  3. A kapcsolat nevét hagyhatja, majd nyomja meg a Kapcsolat mentése gombot. API-kulcsot nem kell megadni.
  4. 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.
  5. 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.
  6. 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.
  7. Megnyílik a Google bejelentkezési oldala. Válassza ki a fiókját.
  8. 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.
  9. 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.
  10. 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:

  1. A kapcsolatok listájában válassza a kapcsolat Szerkesztés hivatkozását.
  2. 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á.
  3. 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.

  1. 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.
  2. Kapcsolja be a Places API (New) és a Routes API szolgáltatást (lásd: A szükséges API-k bekapcsolása).
  3. 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.
  4. 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).
  5. Másolja ki a kulcsot.
  6. 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:

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

Vissza a súgó tartalomjegyzékéhez