Что это
Gmail API — это официальный API для работы с Gmail-ящиком: письма, threads, labels, attachments, drafts, send, search и синхронизация почты. Его используют, когда нужно не просто SMTP-отправка, а полная работа с mailbox.
Для AI-агента Gmail API дает типовой workflow: найти новое письмо, определить тему, вынуть важные данные, обработать вложение, поставить label, создать черновик ответа и передать его человеку на проверку.
Главное правило: не давать AI сразу право отправки. Для почты безопаснее паттерн: read -> classify -> draft -> approval -> send. Так меньше риск утечки, ошибочной рассылки и плохого тона ответа.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Один рабочий день
- Open-source: Нет
- Данные: Высокий контроль
- Чувствительные данные: Только с настройками
Доступные модели и версии
Сильные стороны
- дает нативный доступ к Gmail messages, threads, labels и drafts
- подходит для AI-агентов с черновиками ответов
- можно работать с labels, search queries и threads
- поддерживает watch/history для почти почти в real-time
- хорошо стыкуется с Google Workspace и бизнес-ящиками
Ограничения
- нужна настройка Google Cloud, OAuth consent и scopes
- чувствительные scopes могут требовать verification
- есть quotas, rate limits и ограничения Google Workspace policy
- письма и вложения нужно сильно фильтровать перед LLM
- автоотправка без approval может привести к утечкам и репутационным рискам
Как использовать
Создайте Google Cloud project и включите Gmail API.
Настройте OAuth consent screen и выберите minimal scopes.
Для старта берите read-only scope и отдельно добавляйте compose/send только после approval.
Сохраняйте refresh token в secret manager, а не в коде и не в logs.
Напишите фильтр: какие labels, senders, subjects и threads AI имеет право читать.
Для AI-ответов создавайте draft, а не send: человек проверяет тон, факты и адресатов.
Логируйте message id, thread id, action, status и approver, но не body письма.
Примеры сценариев
- Письмо с заявкой попадает в Gmail: AI вынимает имя, компанию, бюджет и создает lead в CRM.
- Счет в PDF приходит в почту: агент читает вложение, извлекает сумму и готовит задачу бухгалтеру.
- Письма support классифицируются по SLA: billing, bug, urgent, refund, feedback.
- Агент готовит draft reply на частый вопрос и ставит label Waiting for approval.
Доступ и оплата
- Модель оплаты: Бесплатный тариф + платные возможности
- Бесплатный тариф: Да
- Работа в РФ: Ограниченно
- VPN: Иногда может понадобиться
- Русский интерфейс: Да
- Русский язык: Хорошо
Gmail API нужен, если у вас Gmail или Google Workspace и нужна глубокая работа с ящиком. Если нужна массовая рассылка, лучше брать ESP типа SendGrid, Mailgun или Brevo.
Какой тариф выбрать
- Сам Gmail API чаще не добавляет отдельную плату, но важны Google Workspace-тариф, quotas и verification.
- Если AI обрабатывает много писем и вложений, заранее считайте стоимость LLM-вызовов.
- Для support-команды часто выгоднее связать Gmail API с helpdesk/CRM, а не строить все в почте.
Когда не подходит
- массовые маркетинговые рассылки без ESP-платформы
- автоотправка всех ответов без human approval
- хранение OAuth tokens в коде, logs или таблицах
- сценарии, где нужен IMAP/SMTP для разных почтовых серверов
- обход Google Workspace policy, DLP и согласий пользователей
Альтернативы
Microsoft Graph Mail API подходит для Outlook/Microsoft 365. IMAP и SMTP универсальнее, но беднее по функциям. n8n Gmail node удобен, если нужен no-code workflow вместо своего backend.
Когда выбирать
Подходит, если задача совпадает с описанием инструмента и его можно встроить в текущий рабочий процесс без сложной перестройки команды.
На что обратить внимание
Проверьте стоимость, права доступа, экспорт данных, качество результата и возможность отключить инструмент без потери процесса.
Как начать
- Сформулируйте одну рабочую задачу.
- Проведите короткий тест на реальных данных.
- Сравните результат с текущим процессом.
- Решите, нужен ли пилот на команду.
