OAuth2 Google для n8n: один Client ID на всі сервіси — без помилок

Користуватись Google Calendar, Drive чи YouTube для себе і підключити їх до автоматизації — це не одне й те саме. У першому випадку ви просто входите в акаунт. У другому — сторонній застосунок (ваш n8n) має отримати від Google дозвіл діяти від вашого імені: створювати події, читати файли, публікувати відео, тягнути метрики з рекламного кабінету. І Google, маючи десятки різних сервісів, робить це не так, як усі інші: через окрему Google Cloud Console зі своїми проєктами, API, екранами згоди й ключами.

Саме на цьому кроці більшість людей і зупиняється. Не тому, що складно, а тому, що інтерфейс Google не пояснює, навіщо кожен крок, а помилки на кшталт «redirect_uri_mismatch» або «Google hasn't verified this app» виглядають як вирок. Хоча за кожною з них — одна конкретна причина, яка виправляється за хвилину, якщо знати, куди дивитись.

Цей посібник проведе вас від порожнього акаунта до робочих підключень у n8n: проєкт у Google Cloud, увімкнення потрібних API, екран згоди, збір адрес перенаправлення з n8n, створення Client ID і Client Secret, підключення Calendar, Drive, YouTube, Ads, Tasks, Sheets і Docs — усе одним набором ключів. Плюс типові помилки і один нюанс із тестовим режимом, через який підключення «раптом» відвалюються за тиждень.

Що таке OAuth2 і чому Google робить це по-своєму

OAuth2 — це протокол, за яким ви даєте застосунку доступ до своїх даних у сервісі, не передаючи йому пароль. Ви входите в Google самі, підтверджуєте перелік дозволів, а застосунок отримує токен — ключ, який можна відкликати будь-коли, не змінюючи пароль. Для автоматизацій це єдиний правильний спосіб: n8n працює від вашого імені, але пароля не знає.

Google Cloud Console — це хаб, де все це налаштовується. Якщо вам зрозуміліша аналогія з рекламою — це щось на кшталт бізнес-менеджера в Meta, тільки для API та технічних налаштувань: тут живуть проєкти, у проєктах вмикаються API, створюються ключі й описується, як ваш застосунок представлятиметься користувачам на екрані згоди.

Один набір Client ID і Client Secret можна використовувати для кількох сервісів Google одночасно, якщо правильно додати всі адреси перенаправлення. Не треба створювати окремий проєкт під кожну інтеграцію.

Що знадобиться

• Обліковий запис Google — для доступу до Google Cloud Console. Підійде і звичайний Gmail, і акаунт Google Workspace.
• Доступ до n8n — хмарна або власна інсталяція. Інструкція писалась для версії 1.88 і новіших; інтерфейс у наступних версіях може відрізнятись у дрібницях, але логіка та сама.
• Для власної інсталяції — робочий https. Google приймає адреси перенаправлення лише по захищеному протоколу.
• Базове розуміння, що таке API і мінімальне знайомство з інтерфейсом n8n.
• Текстовий файл, куди ви записуватимете адреси перенаправлення і ключі. Не в чат, не в скріншот — у файл, який лежить у безпечному місці.

Які API вмикати під які сервіси

Вмикайте лише те, що плануєте використовувати: кожен увімкнений API — це додаткові дозволи, які потім з'являться на екрані згоди. Додати ще один API можна будь-коли.

Крок за кроком

Крок 1. Проєкт у Google Cloud Console

1. Відкрийте Google Cloud Console і пройдіть просту реєстрацію, якщо ви тут уперше.
2. Угорі натисніть на випадаюче меню проєктів і оберіть New Project.
3. Введіть назву. Раджу назвати за доменом сайту або проєктом, для якого будуєте автоматизацію, — через пів року у вас буде кілька проєктів, і «Project 1» нічого не скаже.
4. Натисніть Create і переконайтесь, що новий проєкт обрано у тому самому меню вгорі. Це найчастіша дрібна помилка: усі наступні кроки робляться в іншому проєкті.

Крок 2. Увімкнення API

1. У лівому меню перейдіть до APIs & Services → Library.
2. Через пошук знайдіть кожен API з таблиці вище, відкрийте його і натисніть Enable.
3. Якщо акаунт зовсім новий, консоль може спершу попросити активувати роботу з API однією кнопкою — натисніть її і повторіть увімкнення.
4. Після кожного увімкнення зʼявляється сповіщення про успіх. Перевірте в розділі увімкнених API, що всі потрібні є у списку.

Крок 3. Екран згоди OAuth

Це сторінка, яку бачить користувач, коли застосунок просить доступ. Без неї Google не видасть ключі, тому цей крок обовʼязковий, навіть якщо користувач — лише ви.

1. У APIs & Services відкрийте OAuth consent screen. У новіших версіях консолі цей розділ може називатись інакше або лежати в окремому меню налаштувань автентифікації — шукайте за словами «consent» або «OAuth».
2. Оберіть тип користувачів. Internal — якщо у вас Google Workspace і доступ потрібен лише людям вашої організації: без верифікації і без обмежень тестового режиму. External — для звичайного Gmail-акаунта або якщо підключатимуться люди ззовні.
3. Натисніть Create і заповніть обовʼязкові поля: App name (наприклад, «n8n Integration»), User support email і Developer contact email — обидві вкажіть свої.
4. У Authorized domains додайте домен: n8n.cloud для хмарної версії або ваш власний домен, якщо n8n на своєму сервері.
5. Натисніть Save and Continue. Сторінку Scopes можна пропустити — n8n сам запитає потрібні обсяги доступу під час авторизації.
6. Ще раз Save and Continue до сторінки Summary, перегляньте і натисніть Back to Dashboard.

Якщо ви обрали External, застосунок стартує у статусі тестування. Для тестового режиму додайте себе (і всіх, хто підключатиме свої акаунти) до списку тестових користувачів — інакше Google не пустить на екран входу. Про наслідки тестового режиму — окремо в розділі про помилки.

Крок 4. Адреси перенаправлення з n8n

Google має знати, куди повертати користувача після входу. Ці адреси генерує n8n, і для кожного типу облікових даних вони свої.

1. У n8n відкрийте Credentials і натисніть Create New.
2. Оберіть тип для потрібного сервісу: Google Calendar OAuth2, Google Drive OAuth2, YouTube OAuth2, Google Ads OAuth2 тощо.
3. У формі знайдіть поле OAuth Redirect URL і скопіюйте його значення у свій текстовий файл. Повторіть для кожного сервісу — адреси можуть відрізнятись.
4. Форми поки не зберігайте — ключів ще немає. Повернемось до них на кроці 6.

Для Google Meet окремих облікових даних не потрібно: посилання на зустрічі створюються через Google Calendar OAuth2, бо Meet інтегрується через календар.

Крок 5. Створення OAuth Client ID

Тепер створимо ключі, за якими n8n представлятиметься Google як довірений застосунок.

1. У Google Cloud Console перейдіть до APIs & Services → Credentials.
2. Натисніть + CREATE CREDENTIALS → OAuth client ID.
3. Тип застосунку — Web application.
4. Введіть назву, наприклад «n8n Integration Client».
5. У Authorized redirect URIs додайте усі адреси з кроку 4 — кожну окремим рядком, без зайвих слешів і пробілів.
6. Натисніть Create. Google покаже Client ID і Client Secret — скопіюйте обидва у свій файл. Секрет потім можна подивитись знову, але краще зберегти одразу.

Крок 6. Підключення у n8n

Для кожного сервісу:

1. Поверніться в n8n до форми облікових даних відповідного типу.
2. Вставте Client ID і Client Secret із кроку 5 — ті самі для всіх сервісів.
3. Натисніть Sign in with Google, оберіть акаунт, підтвердьте дозволи.
4. Збережіть облікові дані. Назвіть їх зрозуміло — «Google Calendar — робочий акаунт» — щоб через місяць не вгадувати.

Крок 7. Використання у воркфлоу

1. Створіть новий воркфлоу і додайте вузол потрібного сервісу: Google Calendar, Google Drive, Google Ads, YouTube тощо.
2. У налаштуваннях вузла оберіть облікові дані, створені на кроці 6.
3. Налаштуйте дію. Наприклад, для Google Calendar — створення події з посиланням на Meet; для Drive — завантаження файлу в певну папку; для YouTube — додавання відео до плейлиста; для Ads — отримання метрик кампанії.
4. Запустіть тестове виконання і подивіться на результат у вузлі: якщо дані прийшли — підключення працює.

Типові помилки і як їх лікувати

• «Google hasn't verified this app». Застосунок у тестовому режимі або не пройшов верифікацію. Для власного використання це нормально: натисніть Advanced → Go to [назва застосунку] (unsafe) і продовжуйте. Слово «unsafe» тут означає лише те, що Google не перевіряв ваш застосунок, а не те, що він небезпечний.
• Невідповідність адреси перенаправлення (redirect_uri_mismatch). Адреса з n8n не додана до Client ID або додана з помилкою — зайвий слеш, http замість https, інший домен. Скопіюйте адресу з поля в n8n ще раз і звірте посимвольно.
• API не увімкнено. Вузол повертає помилку доступу, хоча авторизація пройшла. Перевірте в консолі, що потрібний API увімкнений саме в тому проєкті, де створено Client ID.
• Власна інсталяція без https. Google не прийме адресу перенаправлення по http. Підключіть сертифікат або платформу, яка видає https автоматично.
• Не той акаунт. У кроці 6 ви обрали особистий Gmail, а календар — у робочому Workspace. Перепідключіть облікові дані потрібним акаунтом.
• Підключення відвалюється через тиждень. Найпідступніша. Для застосунків типу External у статусі тестування Google, за власною документацією, видає токени оновлення з обмеженим строком дії — приблизно тиждень. Після цього n8n просить увійти знову. Рішення — перевести застосунок у статус продакшену на сторінці екрана згоди (для власного використання це можливо без повної верифікації, хоча попередження «unverified» лишиться) або, якщо у вас Workspace, обрати тип Internal, де цього обмеження немає.

Безпека і що далі

Client ID і Client Secret — це ключі від ваших даних. Зберігайте їх лише в n8n і у своєму файлі, не пересилайте в месенджерах і не вставляйте у скріншоти. Якщо секрет витік — у консолі його можна перевипустити, і старий перестане працювати. Періодично переглядайте у налаштуваннях безпеки Google-акаунта список застосунків із доступом і прибирайте ті, якими вже не користуєтесь.

Коли підключення працює, найкорисніші перші сценарії такі: нова заявка з форми — подія в Calendar із посиланням на Meet і лист клієнту; новий файл у Drive — повідомлення команді в месенджер; щоденний звіт із Google Ads — у Telegram; нове відео на YouTube — автоматично в потрібний плейлист і анонс у канал. Кожен із них — це три-чотири вузли, і саме на них ви навчитесь усьому іншому.

Якщо ж ви хочете не просто підключити Google, а зрозуміти, які процеси у вашому бізнесі варто автоматизувати першими і в якій послідовності, — приходьте на консультацію на 60 хвилин: вийдете з планом на 30 днів, де кожна інтеграція має свою причину.

Коротко

• OAuth2 дає n8n доступ до Google-сервісів без вашого пароля; токен можна відкликати будь-коли.
• Один Client ID і Client Secret працюють для всіх сервісів Google — головне додати всі адреси перенаправлення з n8n.
• Порядок: проєкт → увімкнути API → екран згоди → зібрати адреси з n8n → створити Client ID → підключити в n8n → перевірити у воркфлоу.
• Google Meet підключається через Google Calendar OAuth2, окремих ключів не потрібно.
• Власна інсталяція n8n має працювати по https, інакше Google не прийме адресу перенаправлення.
• Для External-застосунків у тестовому режимі токени живуть обмежений час — переводьте у продакшен або обирайте Internal у Workspace.
• Ключі зберігайте лише в n8n і у своєму файлі; при витоку — перевипустіть у консолі.

Питання, які ставлять найчастіше

Чи треба створювати окремий проєкт у Google Cloud під кожен сервіс?

Ні. Один проєкт, один Client ID і один Client Secret обслуговують Calendar, Drive, Sheets, Docs, Tasks, YouTube і Ads одночасно. Потрібно лише увімкнути відповідні API в цьому проєкті й додати до Client ID адреси перенаправлення для кожного типу облікових даних n8n.

Чому Google пише, що застосунок не перевірений, і чи це небезпечно?

Google показує це попередження для будь-якого застосунку, який не проходив його верифікацію, — а для власної автоматизації її проходити не потрібно. Ви самі створили цей застосунок і самі даєте йому доступ до свого акаунта. Натисніть Advanced і продовжуйте; небезпеки в цьому немає.

Чому n8n через тиждень знову просить увійти в Google?

Найімовірніше, застосунок типу External досі у статусі тестування, а в ньому Google видає токени оновлення з обмеженим строком дії. Переведіть застосунок у статус продакшену на сторінці екрана згоди або, якщо у вас Google Workspace, перестворіть екран згоди з типом Internal.

Чи можна використати ті самі ключі в іншій інсталяції n8n?

Так, якщо додати до Client ID адреси перенаправлення з тієї інсталяції: у кожного n8n свій домен, а отже, свої адреси. Самі ж облікові дані доведеться створити в новій інсталяції заново, бо вони шифруються її власним ключем.

Що робити, якщо Client Secret потрапив у чужі руки?

У Google Cloud Console на сторінці Credentials відкрийте свій OAuth client і перевипустіть секрет — старий одразу перестане працювати. Потім оновіть секрет у всіх облікових даних n8n і перепідключіть їх.

Про автора

Ігор Ніколенко

Засновник DigitTime, автор Моделі запуску D.N.A.

З 2008 року у професійному Digitalʼі, digital-маркетингу та запусках. Візіонер платформи NEO, Академії Evolve.Place і DigitTime Projects. Пише про те, що перевірив на власних проєктах, а не переказує чужі кейси.

Telegram YouTube Instagram LinkedIn Website

Усі статті автора →