# Google / Gmail kapcsolat

> A Gravity SMTP összekötése Gmail- vagy Google Workspace-fiókkal: Google Cloud alkalmazás létrehozása, beállítások, bejelentkezés és küldés álnévről.

A **Google / Gmail** integrációval a webhelyed a Google API-ján át küldi a kimenő leveleket. A bővítmény OAuth 2.0 hitelesítést használ, vagyis nem kell jelszót beírnod a WordPressbe.

A Gmail ingyenes fiók, a Google Workspace fizetős (iskoláknak és vállalkozásoknak). Próbaidőszakos Workspace-fiók is használható, de küldési és címzetti korlátai vannak, és csak néhány hétig él.

## Mikor ne ezt használd

A Gmail nem tranzakciós levélküldő szolgáltatás, ezért nem való a webhely működéséhez nélkülözhetetlen levelekhez (jelszó-visszaállítás, rendelés-visszaigazolás). A Google a küldési korlátait előzetes értesítés nélkül módosíthatja. Kis forgalmú webhelyhez, kipróbáláshoz vagy a webhelygazda saját értesítéseihez elég lehet. Nagy mennyiségű, időkritikus vagy fontos levélhez válassz a többi, erre készült szolgáltatóból (lásd az [Integrációk](https://hub.hellowp.io/hu/plugins/gravitysmtp/integraciok/) fejezetet).

## A kapcsolat lépései

1. Legyen Google-fiókod. Ha még nincs, hozz létre egyet.
2. Hozz létre egy alkalmazást a Google Cloud Console-ban, és szerezd meg belőle a **Client ID**-t és a kliens titkos kulcsát (lásd [lent](#alkalmazás-létrehozása-a-google-cloud-console-ban)).
3. A WordPressben nyisd meg az **SMTP → Beállítások → Integrációk** oldalt, kattints a **+** gombra, és válaszd a **Google** kártyát.
4. Töltsd ki a **Konfiguráció** részt, és másold ki az **Engedélyezett átirányítási URI** értékét a **Másolás** gombbal.
5. Add hozzá ezt az URI-t a Google Cloud alkalmazás engedélyezett átirányítási URI-jai közé. Ez az OAuth 2.0 hitelesítés lényeges eleme: ide érkezik vissza a válasz a hitelesítő kiszolgálótól.
6. Kattints a **Bejelentkezés a Google-lel** gombra, és jelentkezz be azzal a Google-fiókkal, amely jogosult használni az alkalmazást.
7. Visszatérsz a Google beállítóoldalára, ahol már a kapcsolt állapot látszik. Töltsd ki a további általános beállításokat.
8. Kattints a **Mentés és bekapcsolás** gombra. Mentés után az új integráció kártyája megjelenik az Integrációk oldalon.
9. Próbáld ki a kapcsolatot az [Eszközök](https://hub.hellowp.io/hu/plugins/gravitysmtp/eszkozok/) oldal teszt-küldésével.

![A Google / Gmail beállítások panel a Client ID, a kliens titkos kulcsa és az átirányítási URI mezőkkel](./kepek/szolgaltatok-google-beallitasok.webp)

*A Google / Gmail beállítások panel a Client ID, a kliens titkos kulcsa és az átirányítási URI mezőkkel* (https://minta-bolt.hu/wp-admin/admin.php?page=gravitysmtp-settings&tab=integrations)

A képen a **Konfiguráció** mezői, az **Engedélyezett átirányítási URI** a **Másolás** gombbal, és a **Bejelentkezés a Google-lel** gomb látszik. A bejelentkezés gomb addig halvány, amíg a két kötelező mező üres.

## Beállítások

### Konfiguráció

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Client ID** | A Google által adott azonosító, amellyel a bővítmény hitelesít a Google API-nál. Kötelező. | üres |
| **Kliens titkos kulcsa** | A Google által adott titkos kulcs (Client Secret). Kötelező. | üres |
| **Engedélyezett átirányítási URI** | Az az URL a webhelyeden, ahová a Google a bejelentkezés után visszaküldi a felhasználót. Ezt kell beírnod a Google Cloud alkalmazásba. Csak olvasható, a **Másolás** gombbal viszed át. | a webhelyed címe alapján kitöltve |

### Általános beállítások

A kapcsolat létrejötte után jelennek meg.

| Beállítás | Mit csinál | Alapérték |
|---|---|---|
| **Visszaküldési útvonal** | A kézbesíthetetlenségi értesítések címét az e-mail fejlécébe írja. Nélküle a visszapattanó üzenetek elveszhetnek. | kikapcsolva |
| **Alapértelmezett feladói e-mail-cím** | A kimenő levelek feladója. A csatlakoztatott fiók címe vagy ahhoz tartozó álnév lehet. Csak akkor érvényesül, ha a levél nem ad meg saját feladót. | üres |
| **Feladó e-mail-címének kényszerítése** | Bekapcsolva ez a cím felülírja minden kimenő levélnél a bővítmények beállításait. | kikapcsolva |
| **Alapértelmezett feladó neve** | A feladó neve, ugyanazzal a szabállyal. | üres |
| **Feladó nevének kényszerítése** | Minden levélnél ezt a nevet használja. | kikapcsolva |
| **Alapértelmezett válaszcím** | A válaszcím, ha a levél nem ad meg sajátot. | üres |
| **Válaszcím kényszerítése** | Minden levélnél ezt a válaszcímet használja. | kikapcsolva |

## Alkalmazás létrehozása a Google Cloud Console-ban

A Gravity SMTP-nek egy saját alkalmazásra van szüksége a Google Cloudban. Ezt a lépést az integráció beállítása előtt végezd el. Szükséged van egy Google-fiókra, amely hozzáfér a Google Cloud Console-hoz. A Gmail API bekapcsolásához és normál mennyiségű levél küldéséhez nem kell számlázási fiók.

### 1. Projekt létrehozása

1. Nyisd meg a Google Cloud Console-t.
2. A felső sáv projektválasztó legördülő menüjében hozz létre új projektet, vagy válassz egy meglévőt.
3. Győződj meg róla, hogy a kiválasztott projekt az aktív.

### 2. A Gmail API bekapcsolása

1. A konzolban nyisd meg az **APIs & Services** részt, és kattints a **Library** menüpontra.
2. Keress rá a „Gmail API” kifejezésre, és válaszd ki a találatot.
3. Kattints az **Enable** gombra.

### 3. OAuth2 alkalmazás regisztrálása

Ez a lépés csak új alkalmazás regisztrálásához kell. Ha már van alkalmazásod, ugorj a 4. lépésre.

1. A bal oldali menüben válaszd a **Google Auth Platform** pontot. Új projektnél „Google Auth platform not configured yet” üzenetet látsz: kattints a **Get Started** gombra.
2. **App Information**: add meg az alkalmazás nevét és egy támogatási e-mail-címet.
3. **Audience**: válaszd az **External** lehetőséget, és kattints a **Next** gombra.
4. **Contact Information**: add meg a fejlesztő elérhetőségi e-mail-címét.
5. **Finish**: nézd át, fogadd el a Google API Services User Data Policy-t, majd kattints a **Continue** és a **Create** gombra.

### 4. OAuth2 hitelesítő adatok létrehozása

1. A Google Auth Platformon belül kattints a bal oldali menü **Clients** fülére.
2. Kattints a **Create Client** gombra.
3. Az alkalmazás típusa legyen **Web application**.
4. Adj nevet az OAuth kliensnek, és az **Authorized redirect URIs** közé másold be a Gravity SMTP Google-beállításai között látható **Engedélyezett átirányítási URI** értékét.
5. Kattints a **Create** gombra. A létrejövő ablakban látod a **Client ID**-t és a **Client Secret**-et: ezeket másold be a Gravity SMTP megfelelő mezőibe.

### 5. Az alkalmazás közzététele

1. A Google Auth Platformon nyisd meg az **Audience** részt, és kattints a **Publish App** gombra.
2. A megjelenő ablakban erősítsd meg a **Push to Production** gombbal.

Amíg az alkalmazás nem megy át a Google hivatalos ellenőrzésén, a hozzáférést engedélyező felhasználók (te is) egy „unverified app” (nem ellenőrzött alkalmazás) képernyőt látnak. Ez a küldést nem akadályozza, a bejelentkezéskor tovább lehet lépni.

## Küldés álnévről (alias)

A kimenő levelek feladója lehet a Gmail-fiók egy álneve is. Ehhez az álnevet a Gmailben fel kell venni „Küldés ebből a címből” feladónak, és csak utána adhatod meg a Gravity SMTP **Alapértelmezett feladói e-mail-cím** mezőjében.

### Új álnév létrehozása (csak Google Workspace)

Ez a rész a Google Workspace rendszergazdáknak szól. Sima Gmail-fióknál ugord át, és kezdd a következő résszel. Ha nincs hozzáférésed a Workspace Admin Console-hoz, kérd meg a rendszergazdát.

1. Jelentkezz be a Google Workspace Admin Console-ba.
2. Nyisd meg a **Users** részt, és válaszd ki azt a felhasználót, akihez az álnevet adod.
3. Kattints a **User Information**, majd az **Email Aliases** pontra.
4. Kattints az **Add an Alias** gombra, írd be az új álnevet, és mentsd.

### Az álnév felvétele feladóként a Gmailben

1. Jelentkezz be a Gmail-fiókba.
2. Kattints a fogaskerék ikonra, és válaszd a **See all settings** pontot.
3. Nyisd meg az **Accounts** fület.
4. A **Send mail as** részben kattints az **Add another email address** gombra.
5. Add meg az álnév nevét és e-mail-címét. A **Treat as an alias** jelölőnégyzet legyen bejelölve.
6. Kattints a **Next Step**, majd a **Send Verification** gombra.
7. Az álnév címére érkezett levélben kattints a megerősítő hivatkozásra.

Ezután a Gravity SMTP Google-integrációjában az **Alapértelmezett feladói e-mail-cím** mezőbe az álnevet írd be.