Использование REST API почты Outlook
Microsoft Graph позволяет вашему приложению получать авторизованный доступ к данным почты Outlook в личной или корпоративной учетной записи. С соответствующими делегированными разрешениями или разрешениями на почту приложения ваше приложение может получить доступ к почтовым данным пользователя, выполнившего вход, или любого пользователя в клиенте. Дополнительные сведения о маркерах доступа, регистрации приложений, делегированных разрешениях и разрешениях приложений см. в статье Основные сведения о проверке подлинности и авторизации.
API Microsoft Graph поддерживает доступ к данным в основных и общих почтовых ящиках пользователей. Это может быть календарь, почта или личные контакты в почтовом ящике, хранящиеся в облаке на сервере Exchange Online в Microsoft 365 или на локальном сервере Exchange в гибридном развертывании.
API не поддерживает доступ к почтовым ящикам архива на месте ни на сервере Exchange Online, ни на сервере Exchange Server.
Использование REST API почты
Запросы API почты выполняются от имени пользователя, который может определяться свойством пользователя id (уникальным GUID), адресом электронной почты или псевдонимом me, обозначающим вошедшего пользователя.
Email сообщения представлены ресурсом сообщений и организованы в mailFolder.
Сообщения и почтовые папки определяются их свойством id , которое можно получить из GET операций.
Важно!
Идентификаторы message и mailfolder не являются уникальными и неизменными в почтовом ящике. Они могут изменяться, например после копирования или перемещения. Вы можете использовать неизменяемые идентификаторы, чтобы сохранять их, пока сообщение находится в том же почтовом ящике, за исключением отправки черновика и нескольких других сценариев. Подробные сведения см. в разделе жизненный цикл неизменяемых идентификаторов.
Сообщения могут быть в формате HTML или текстовом формате.
Вы можете использовать такие известные имена папок, как Inbox, Drafts, SentItems или DeletedItems, чтобы указать почтовые папки, которые существуют по умолчанию для всех пользователей. Список поддерживаемых известных имен см. в статье Тип ресурса mailFolder.
Например, вы можете получить сообщения из папки Outlook Отправленные вошедшего пользователя, не получая идентификатор папки:
GET /me/mailFolders('SentItems')/messages?$select=sender,subject
Основные варианты использования
Ресурс message предоставляет такие свойства, как categories, conversationId, flag и importance, которые соответствуют функциям, доступным в пользовательском интерфейсе, позволяя приложениям автоматизировать работу или интегрироваться со встроенными возможностями Outlook.
В API Microsoft Graph также есть методы и действия, которые поддерживают основные варианты использования сообщений.
| Варианты использования | Ресурсы REST | См. также |
|---|---|---|
| Действия, ориентированные на пользователя | ||
| Создание, чтение, ответ, пересылка, отправка, обновление или удаление сообщений | message | Методы ресурса message |
| Предоставление другому пользователю права отправлять сообщения от имени владельца почтового ящика | message | Задание свойств from и sender в ресурсе message |
| Показ более важных сообщений | inferenceClassificationOverride | Сортировка почты |
| Запрос сообщений и их получение в папке поиска | mailSearchFolder | Методы ресурса mailSearchFolder |
| Получение содержимого MIME сообщения или его вложения | message | Получение содержимого MIME |
| Отправка сообщений с содержимым MIME | message | Отправка содержимого MIME |
| Добавление, получение или удаление вложений сообщения |
attachment, fileAttachment, itemAttachment, referenceAttachment, message |
Методы ресурса attachment |
| Получение настроек языка и часовых поясов для пользователя |
localeInfo, timeZoneInformation |
supportedLanguages, supportedTimeZones |
| Получение или обновление автоматического ответа, языкового стандарта, часового пояса или рабочего времени пользователя |
mailboxSettings, automaticRepliesSetting, localeInfo, workingHours |
Получение настроек почтового ящика пользователя, Обновление параметров почтового ящика пользователя |
| Получение подсказок об особом состоянии других пользователей, например об отсутствии на месте |
user, mailTips |
Получение подсказок |
| Управление почтой и папками | ||
| Упорядочивание сообщений в иерархии папок почты | mailFolder | Методы ресурса mailFolder |
| Классификация сообщений | outlookCategory | Методы ресурса outlookCategory |
| Автоматизация действий, например пересылка определенных входящих сообщений, с помощью правил папки "Входящие" | messageRule | Методы ресурса messageRule |
| Получение заголовков сообщений Интернета для сообщения | message | Получение свойства internetMessageHeaders сообщения. |
| Поиск и фильтрация сообщений | message | Параметры запроса |
| Получение уведомлений об изменениях сообщений в папке | subscription | Работа с веб-перехватчиками в Microsoft Graph |
| Синхронизация сообщений или иерархии папок почты | message | Получение добавочных изменений сообщений в папке |
| Разработка приложений | ||
| Получение пользовательских данных приложения в виде заголовков сообщений Интернета для сообщения | message | Добавление пользовательских данных в свойство internetMessageHeaders сообщения. |
| Добавление пользовательских данных приложения в сообщение с помощью расширений |
openTypeExtension, schemaExtension |
Добавление пользовательских данных в ресурсы с помощью расширений |
| Доступ к пользовательским данным для редко предоставляемых свойств Outlook MAPI |
singleValueLegacyExtendedProperty, multiValueLegacyExtendedProperty |
Общие сведения о расширенных свойствах Outlook |
Дальнейшие действия
API почты открывает новые способы взаимодействия с пользователями:
- Обзор API почты Outlook
- Узнайте больше о методах, свойствах и отношениях ресурсов message и mailFolder.
- Опробуйте API в песочнице Graph.