Gmail

Gmail — это интеграция с Gmail API через управляемую OAuth-аутентификацию. Она позволяет читать, отправлять и управлять письмами, цепочками, ярлыками и черновиками. Используйте этот инструмент, когда необходимо взаимодействовать с Gmail напрямую.

Обзор

Данный инструмент предоставляет доступ к Gmail API через прокси-шлюз, который автоматически управляет OAuth-токенами. Это упрощает интеграцию и избавляет от необходимости вручную реализовывать авторизацию.

• Чтение писем
• Отправка сообщений
• Работа с цепочками писем
• Управление ярлыками
• Создание черновиков

Быстрый старт

Пример запроса для получения списка писем:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/google-mail/gmail/v1/users/me/messages?maxResults=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

Все запросы отправляются через следующий шлюз:

https://gateway.maton.ai/google-mail/{native-api-path}

Замените {native-api-path} на соответствующий путь Gmail API. Например:

https://gateway.maton.ai/google-mail/gmail/v1/users/me/messages

Важно: путь обязательно должен начинаться с имени приложения (например, /google-mail/), чтобы шлюз корректно определил подключение.

Аутентификация

Для всех запросов требуется API-ключ Maton, передаваемый в заголовке:

Authorization: Bearer $MATON_API_KEY

Установите переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Получение API-ключа

• Создайте аккаунт или войдите в систему на maton.ai
• Перейдите в настройки аккаунта
• Скопируйте API-ключ

Управление подключениями

OAuth-подключения к Google управляются через специальную панель управления. Там можно создавать, удалять и обновлять подключения для доступа к Gmail.

Ресурсы

• Обзор Gmail API
• Список сообщений
• Получение письма
• Отправка письма
• Список цепочек
• Список ярлыков
• Создание черновика