Что это
Microsoft Graph Mail API - программный доступ к почтовым данным Outlook. Приложение может получить список сообщений, подготовить черновик или обработать вложение. Каждая операция требует подходящих прав; чтение и отправку не следует объединять в один неограниченный доступ.
Для помощника сначала достаточно списка тем учебных писем. Базовое разрешение Mail.ReadBasic не дает содержимое и вложения. Если нужна выжимка самого письма, отдельно согласуйте расширение доступа и передачу текста модели. API не анализирует переписку с помощью AI сам по себе.
Поддерживаются предусмотренные Microsoft почтовые аккаунты и сценарии доступа к общим ящикам. Это не универсальный интерфейс ко всем IMAP-серверам. Перемещение сообщений может менять обычный ID: при синхронизации учитывайте этот факт и механизм immutable IDs.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Доступ к папкам и сообщениям позволяет автоматизировать сбор почтовых данных без кликов в Outlook.
- Базовые права позволяют начать с тем и других основных свойств, не читая тело письма.
- Работа с черновиком и отправка разделены: можно сначала показать человеку подготовленный ответ.
- Выбор полей и постраничная выдача помогают ограничивать объем получаемых данных.
Ограничения
- Для содержимого, вложений, изменения и отправки нужны соответствующие разрешения, а не только вход в Microsoft.
- Mail.ReadWrite не включает право отправки; для нее отдельно предусмотрено Mail.Send.
- Обычный ID сообщения может измениться после перемещения: его нельзя считать постоянным идентификатором.
- Письма могут содержать секреты и инструкции злоумышленника; передачу модели и действия по письму нужно ограничивать.
Как использовать
1. Подготовка. Используйте отдельный учебный почтовый аккаунт Outlook. Подготовьте несколько писем без персональных данных и запишите их темы. Первый тест - только чтение основных свойств.
2. Настройка. В Graph Explorer войдите этим пользователем и проверьте делегированное Mail.ReadBasic. Уточните требования организации к согласию. Не добавляйте Mail.Send и права изменения для простого списка входящих.
3. Первый результат. Выполните GET https://graph.microsoft.com/v1.0/me/mailFolders/inbox/messages?$top=5&$select=id,subject,receivedDateTime. Получите до пяти сообщений с темами и датами. Маршрут /me требует вошедшего пользователя; в собственном приложении нужен OAuth Bearer-токен.
4. Проверка. Сверьте темы с папкой Входящие в Outlook. Проверьте, что письма не изменились и не отправлялись. Если нужен весь список, следуйте полному @odata.nextLink. Текст письма подключайте позже с подходящими правами; перед отправкой ответа проверяйте получателей, содержание и подтверждение человека.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Доступ определяется почтовым аккаунтом, лицензиями организации и разрешениями приложения. Не обещается универсальный бесплатный корпоративный API. Доступность оплаты из России здесь не подтверждена.
Когда не подходит
- Читать произвольный ящик без разрешения
- Отправлять ответы по решению модели без проверки
- Считать Mail.ReadBasic доступом к тексту и вложениям
Альтернативы
Gmail API подходит для Gmail. IMAP читает почту серверов, которые поддерживают этот протокол, но не заменяет все возможности Outlook Graph. Общий Graph API нужен, когда почтовый сценарий связан с другими ресурсами Microsoft.
