Подключите Gmail к ИИ-агенту

Способы аутентификации

• OAuth 2.0

Откройте локальную консоль, выберите провайдера и настройте учётные данные. Для OAuth-провайдеров нужно зарегистрировать собственное OAuth-приложение в соответствующем сервисе.

Что проверить у этого коннектора

Пример get_profile читает идентификатор почтового ящика и счётчики, но не тела писем. Проверьте emailAddress; messagesTotal и threadsTotal — количества, historyId — курсор. До выполнения проверьте необходимый scope чтения Gmail.

Проверьте Action перед вызовом

Назначение примера

Получение профиля и счётчиков подключённого почтового ящика Gmail.

Необходимые разрешения Action

• https://www.googleapis.com/auth/gmail.readonly

Получите схему из работающего экземпляра. Перед выполнением проверьте обязательные параметры, права и подключённый аккаунт.

curl -s http://localhost:3000/v1/actions/gmail.get_profile

После подключения аккаунта адаптируйте параметры к своим ресурсам. Если включена аутентификация runtime, добавьте его Bearer Token.

curl -s -X POST \
  http://localhost:3000/v1/actions/gmail.get_profile \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

Как читать результат

Ответы HTTP runtime содержат success, message, data и meta. Проверяйте success и выходную схему Action, а не только HTTP-статус. Если метаданные содержат executionId, по нему можно найти журнал с замаскированными секретами. Ниже показан формат ответа, а не результат реального вызова API.

{
  "success": true,
  "message": "OK",
  "data": {
    "emailAddress": "reader@example.com",
    "messagesTotal": 12,
    "threadsTotal": 8,
    "historyId": "12345"
  },
  "meta": {}
}

Если вызов не удался

• При ошибке аутентификации проверьте адрес и тип учётных данных: административный доступ защищает /api, Bearer-токен runtime используется для /v1 и /mcp. API-ключ провайдера не заменяет токен runtime.
• При отказе в доступе проверьте scopes Action, правила Actions и разрешения на подключения. Даже действительный токен может не иметь доступа к выбранному аккаунту.
• Если результат пуст или ресурс отсутствует, проверьте аккаунт и его права на этот ресурс. Успешная авторизация не открывает все рабочие пространства, каналы и документы.
• Изучите ошибку и журнал до повтора. Если Action изменяет данные провайдера, сначала проверьте, не завершилась ли операция; не повторяйте запрос вслепую.

Дальнейшие шаги

Для поддерживаемых провайдеров OOMOL настраивает OAuth-приложения и управляет облачной средой. Вы по-прежнему выбираете аккаунт и подтверждаете его разрешения.