#Почему Gmail — это другая история
Продолжаю серию инструкций по подключению почты к AI-агенту. Яндекс был простым. Gmail — нет. Google не принимает обычные пароли для доступа через IMAP. Вообще. Никогда. Нужно создавать OAuth-приложение.
Звучит страшно, но по шагам — терпимо.
#Шаг 1: Создайте проект в Google Cloud Console
Зайдите на console.cloud.google.com -> Создать проект -> Дайте ему любое имя (например, «Мой AI-агент»).
#Шаг 2: Включите Gmail API
В проекте: APIs & Services -> Library -> найдите «Gmail API» -> Enable.
#Шаг 3: Настройте OAuth Consent Screen
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-агент откроет ссылку -> вы логинитесь -> разрешаете доступ -> готово. Однотипная процедура, но для каждого ящика — отдельный клик.
#Грабли
- Забыл добавить ящик в Test Users — авторизация молча не работает
- Выбрал не те scopes — бот видит письма, но не может отвечать. Нужны как минимум
Gmail.readonlyиGmail.send - Токен протухает — Google выдаёт refresh token, но если приложение в «Testing» режиме, токен живёт 7 дней. Перевёл в Production — теперь не требует верификации для менее 100 пользователей
#Результат
После настройки — полный доступ ко всем Gmail-ящикам. Чтение, отправка, поиск, фильтры. Один раз настроили — работает.
Пошаговый гид по сборке AI-продукта без команды — бесплатно на канале @popovvii