Как подключить Gmail к AI-боту: OAuth-квест для терпеливых

Как подключить Gmail к AI-боту: OAuth-квест для терпеливых

#Почему Gmail — это другая история

Продолжаю серию инструкций по подключению почты к AI-агенту. Яндекс был простым. Gmail — нет. Google не принимает обычные пароли для доступа через IMAP. Вообще. Никогда. Нужно создавать OAuth-приложение.

Звучит страшно, но по шагам — терпимо.

#Шаг 1: Создайте проект в Google Cloud Console

Зайдите на console.cloud.google.com -> Создать проект -> Дайте ему любое имя (например, «Мой AI-агент»).

#Шаг 2: Включите Gmail API

В проекте: APIs & Services -> Library -> найдите «Gmail API» -> Enable.

APIs & Services -> OAuth Consent Screen -> External -> заполните минимум полей (название приложения, email).

Важно: добавьте каждый свой Gmail-ящик как Test User. Без этого авторизация не сработает, и Google не скажет почему.

#Шаг 4: Создайте OAuth Client ID

APIs & Services -> Credentials -> Create Credentials -> OAuth Client ID -> Desktop App. Скачайте JSON-файл с credentials. Он понадобится вашему AI-агенту.

#Шаг 5: Авторизуйте каждый ящик

Для каждого Gmail-ящика нужно пройти OAuth-авторизацию в браузере. AI-агент откроет ссылку -> вы логинитесь -> разрешаете доступ -> готово. Однотипная процедура, но для каждого ящика — отдельный клик.

#Грабли

  1. Забыл добавить ящик в Test Users — авторизация молча не работает
  2. Выбрал не те scopes — бот видит письма, но не может отвечать. Нужны как минимум Gmail.readonly и Gmail.send
  3. Токен протухает — Google выдаёт refresh token, но если приложение в «Testing» режиме, токен живёт 7 дней. Перевёл в Production — теперь не требует верификации для менее 100 пользователей

#Результат

После настройки — полный доступ ко всем Gmail-ящикам. Чтение, отправка, поиск, фильтры. Один раз настроили — работает.


Пошаговый гид по сборке AI-продукта без команды — бесплатно на канале @popovvii

Поделиться: Telegram LinkedIn X

Больше — в канале

Практические кейсы AI-автоматизации для предпринимателей

Vladislav Popov

Владислав Попов

AI-консультант, 15+ лет в IT, PhD (University of York). Помогаю предпринимателям автоматизировать бизнес с помощью AI.