Jak połączyć n8n na Dockerze z Google API bez błędów

Nie znalazłem sensownego opisu tekstowego, więc wszystko rzeźbiłem z tutoriali na YouTube, klatka po klatce. Oglądanie tego to była droga przez mękę. Proces jest jednak krytyczny, bo podłączenie API to pierwszy mur, w który uderzysz przy n8n. Poniżej konkret: pełny przewodnik dla instancji n8n postawionej na localhost (Docker). Żadnego lania wody.

Ten poradnik dotyczy wyłącznie sytuacji, gdy hostujesz n8n na własnym komputerze jako kontener Dockera. To fundament, bez którego nie ruszysz z automatyzacją Google.

Krok 1: Google Cloud Console

Całą zabawę zaczynamy w panelu Google, nie w n8n. To tam musisz wyprosić dostęp do ich zabawek.

1. Otwórz w przeglądarce adres: console.cloud.google.com.
2. Zaloguj się na konto Gmail, które ma być sercem Twoich automatyzacji.

Krok 2: Projekt to podstawa

Google musi wiedzieć, kto puka do drzwi. Musisz stworzyć osobny projekt dla n8n.

1. Na górnym pasku kliknij nazwę obecnego projektu (lub "Select a project").
2. Wybierz New Project.
3. Nadaj mu nazwę, np. n8n-local-integration i kliknij Create.
4. Upewnij się, że po utworzeniu projekt jest wybrany jako aktywny.

Krok 3: Włączanie narzędzi (API Library)

Projekt to tylko puste pudełko. Musisz do niego wrzucić konkretne narzędzia Google.

• W menu po lewej wybierz APIs - Services > Library.
• Wyszukaj i włącz (ENABLE) następujące pozycje:
  • Google Drive API (absolutny fundament dla plików).
  • Google Sheets API (jeśli planujesz pracę na arkuszach).
  • Gmail API (do automatyzacji poczty).

Krok 4: Konfiguracja OAuth Consent Screen

To tutaj definiujesz, że Twoja "aplikacja" jest w fazie testów i Ty jesteś jej jedynym użytkownikiem.

1. Wybierz OAuth consent screen z lewego menu.
2. Zaznacz typ External i kliknij Create.
3. Wypełnij tylko niezbędne pola: App name, User support email oraz Developer contact information.
4. Przejdź przez sekcję Scopes bez zmian (Save and Continue).
5. Krytyczny moment: Test users. Kliknij Add users i wpisz swój adres Gmail. Bez tego Google zablokuje Cię na starcie.

Krok 5: Generowanie Client ID i Client Secret

To są Twoje klucze do królestwa. Bez nich n8n nie pogada z Google.

1. Wejdź w zakładkę Credentials.
2. Kliknij + Create Credentials > OAuth client ID.
3. Jako Application type wybierz Web application.
4. W sekcji Authorized redirect URIs kliknij ADD URI i wklej: http://localhost:5678/rest/oauth2-credential/callback.
5. Po kliknięciu Create otrzymasz dwa kody. Skopiuj Client ID oraz Client Secret do Notatnika. Będą potrzebne przy każdym nowym połączeniu.

Krok 6: Finał w n8n

W n8n nie ma jednego "głównego" logowania do Google. Musisz stworzyć oddzielne poświadczenia (Credentials) dla każdej usługi, używając tych samych kluczy z Kroku 5.

Przykład dla Google Sheets:

1. W n8n wejdź w Credentials > Add Credential.
2. Wyszukaj Google Sheets OAuth2 API.
3. Wklej swój Client ID oraz Client Secret.
4. Kliknij Connect my account.

Uwaga na ostrzeżenie Google: Zobaczysz komunikat o braku weryfikacji aplikacji. Kliknij Advanced, a następnie link na samym dole: Go to [Twoja Nazwa] (unsafe). To normalne przy własnych projektach API.