Google OAuth w n8n to mechanizm uwierzytelniania, który pozwala automatyzacjom bezpiecznie łączyć się z usługami Google (Gmail, Drive, Sheets, Calendar) bez przechowywania Twojego hasła. Kluczem jest utworzenie aplikacji w Google Cloud Console i uzyskanie Client ID oraz Client Secret.
Podstawy: jak działa OAuth w n8n
| Komponent | Rola w procesie |
|---|---|
| Google Cloud Project | Środowisko, w którym tworzysz aplikację i włączasz API |
| OAuth Consent Screen | Ekran zgody pokazujący użytkownikowi, jakie uprawnienia aplikacja wymaga |
| Client ID + Client Secret | Unikalne poświadczenia identyfikujące Twoją aplikację w n8n |
| Redirect URI | Adres callback w n8n, gdzie Google przekieruje po autoryzacji |
| Scopes | Szczegółowe uprawnienia (np. googleapis.com/auth/drive.readonly) |
Krok 1: utwórz projekt w Google Cloud Console
- Wejdź na
console.cloud.google.comi zaloguj się kontem Google - Kliknij selektor projektu New Project
- Nadaj nazwę (np. „n8n Automation”) i kliknij Create
- Zweryfikuj, że nowy projekt jest aktywny w selektorze na górze strony
Krok 2: włącz wymagane API
(Kliknij by powiększyć zdjęcia)
Każda usługa Google wymaga osobnego API. Dla przykładu:
- Gmail to Gmail API
- Google Sheets to Google Sheets API
- Drive to Google Drive API (wymagane również dla Docs/Slides)
- Calendar to Google Calendar API
Proces: w menu – Interfejsy API i Usługi wyszukaj nazwę API, kliknij WŁĄCZ.
Krok 3: skonfiguruj ekran zgody OAuth
- Z menu wybierz Interfejsy API i Usługi > Ekran zgody OAuth
- Wybierz Typ:
- Zewnętrzny – dla zwykłych kont Gmail (domyślnie w trybie testowym)
- Wewnętrzny – tylko dla Google Workspace Twojej organizacji
- Wypełnij: Nazwę aplikacji, E-mail wsparcia użytkownika, Kontakt dla programistów
Krok 4: utwórz credential OAuth 2.0 (Client ID + Secret)
- Z menu wybierz Platforma uwierzytelniania Google – Klienty
- Kliknij Utwórz klienta.
- Typ Aplikacji: wybierz Aplikacja internetowa
- Nadaj nazwę (np. „n8n OAuth Client”)
- W Autoryzowane identyfikatory URI przekierowania wklej adres callback z n8n:
- Self-hosted:
http://localhost:5678/rest/oauth2-credential/callback - n8n Cloud:
https://twoja-instancja.n8n.cloud/oauth2-credential/callback
- Self-hosted:
- Kliknij Utwórz – pojawi się modal z Client ID i Client Secret
Krok 5: dodaj credential do n8n
- W n8n otwórz dowolny węzeł Google (np. Google Sheets) w karcie Credentials kliknij Create New
- Wybierz Google OAuth2 API (lub Custom OAuth2)
- Wklej Client ID i Client Secret z Google Cloud
- Kliknij Sign in with Google
- Zaloguj się na swoje konto Google i kliknij Allow, aby przyznać uprawnienia
- Zapisz credential – możesz go używać we wszystkich węzłach Google w tym workflow
Nadawanie uprawnień (scopes)
Po pierwszej autoryzacji Google pokazuje listę scope, czyli konkretnych uprawnień (np. „Odczytuj i zarządzaj plikami w Google Drive”). n8n automatycznie żąda potrzebnych scopes w zależności od węzła, ale możesz je sprawdzić/edytować w:
- Google Cloud → OAuth consent screen → Scopes → Add or Remove Scopes
- W n8n uprawnienia (credentials) są przechowywane jako token refresh, który automatycznie odnawia dostęp
Ważne uwagi praktyczne
| Sytuacja | Rozwiązanie |
|---|---|
| „Google hasn’t verified this app” | Dodaj swój email jako Test user (External) albo użyj Internal + tego samego konta |
| Token wygasa co 7 dni | Tryb testowy External = tokens ważny 7 dni. Rozwiązania: opublikuj aplikację (wymaga weryfikacji) lub użyj Internal |
| „redirect_uri_mismatch” | Redirect URI w Google Cloud musi być identyczny jak w n8n, łącznie z / na końcu |
| n8n Cloud | Możesz użyć Managed OAuth2 – wystarczy kliknąć „Sign in with Google”, bez konfiguracji w Google Cloud |
Praktyczne zastosowania
Po skonfigurowaniu OAuth w n8n możesz budować automatyzacje takie jak:
- Automatyczne tworzenie wydarzeń w Google Calendar z triggerów (np. formularze, e-maile)
- Czytanie/zapis w Google Sheets – synchronizacja danych z CRM, bazami danych, AI
- Zarządzanie plikami w Google Drive – Backup, generowanie dokumentów, organizacja
- Automatyzacja Gmaila – wysyłka e-maili, filtrowanie, reakcje na wiadomości
- Multiservice workflows – połączenie Google ze Slackiem, Telegramem, bazami danych, modelami AI
Źródła
- n8n Docs: Google OAuth2 single service
- How to Set Up Google Cloud Credentials for N8N
- Google Credentials w n8n – tutorial krok po kroku
- How To Set Up Google Credentials For N8n
