Использование REST API почты Outlook

  • Статья

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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		 Получение подсказок
Оповещение пользователя при его упоминании в других сообщениях (предварительная версия) mention (предварительная версия) Получение сведений об @упоминаниях в сообщении
Отмена подписки пользователя на список рассылки электронной почты (предварительная версия) message (предварительная версия) Отмена подписки
Управление почтой и папками
Упорядочивание сообщений в иерархии папок почты mailFolder Методы ресурса mailFolder
Классификация сообщений outlookCategory Методы ресурса outlookCategory
Автоматизация действий, например пересылка определенных входящих сообщений, с помощью правил папки "Входящие" messageRule Методы ресурса messageRule
Получение заголовков сообщений Интернета для сообщения message Получение свойства internetMessageHeaders сообщения.
Поиск и фильтрация сообщений message Параметры запроса
Получение уведомлений об изменениях сообщений в папке subscription Работа с веб-перехватчиками в Microsoft Graph
Синхронизация сообщений или иерархии папок почты message Получение добавочных изменений сообщений в папке
Разработка приложений
Получение пользовательских данных приложения в виде заголовков сообщений Интернета для сообщения message Добавление пользовательских данных в коллекцию internetMessageHeaders сообщения.
Добавление пользовательских данных приложения в сообщение с помощью расширений openTypeExtension,
schemaExtension		 Добавление пользовательских данных в ресурсы с помощью расширений
Доступ к пользовательским данным для редко предоставляемых свойств Outlook MAPI singleValueLegacyExtendedProperty,
multiValueLegacyExtendedProperty		 Общие сведения о расширенных свойствах Outlook

Дальнейшие действия

API почты открывает новые способы взаимодействия с пользователями: