Автоматизация создания, отправки и обработки сообщений

В Microsoft Graph электронные письма представлены ресурсом message.

По умолчанию сообщения можно идентифицировать по уникальному идентификатору записи в свойстве id. При первоначальном создании и сохранении сообщения в качестве черновика или отправленного сообщения поставщик услуг хранилища назначает этому сообщению идентификатор записи. По умолчанию этот идентификатор изменяется при копировании сообщения или его перемещении в другую папку, хранилище или PST-файл. Для дальнейшей обработки сообщение указывается по текущему идентификатору.

Создание и отправка электронной почты

В Outlook вы можете создавать и отправлять электронные письма в одном и том же действии sendMail. Вы также можете создать черновик, затем добавить содержимое и отправить черновик.

Аналогично, при ответе на электронное письмо вы можете создавать и отправлять ответы в одном и том же действии (ответить, ответить всем или переслать). Кроме того, вы можете создать черновик для ответа (ответить, ответить всем или переслать), добавить содержимое, а затем отправить черновик позже.

Чтобы программным способом отличать черновики от отправленных писем, проверяйте свойство isDraft.

По умолчанию черновики сообщений сохраняются в папке Drafts, а отправленные сообщения — в папке Sent Items. Для удобства вы можете определить папки "Черновики" и "Отправленные", используя их соответствующие хорошо известные имена папок.

Установка свойств from и sender

В процессе создания сообщения в большинстве случаев Outlook указывает в качестве значения свойств from и sender одного и того же пользователя, вошедшего в систему. Вы можете изменить эти свойства в указанных ниже ситуациях.

• Свойство from можно изменить, если администратор Exchange назначил права на отправку почтовых ящиков другим пользователям. Администратор может сделать это, выбрав Разрешения для почтового ящика владельца почтового ящика в портал Azure либо с помощью Центра Администратор Exchange или командлета Windows PowerShell Add-ADPermission. Затем можно программно задать свойство from одному из этих пользователей с правами sendAs для этого почтового ящика.
• Свойство sender можно изменить, если владелец почтового ящика предоставил одному или нескольким пользователям права на отправку сообщений из этого почтового ящика. Владелец почтового ящика может делегировать разрешения в Outlook. Когда представитель отправляет сообщение от имени владельца почтового ящика, Outlook присваивает свойству sender учетную запись представителя, а в качестве значения свойства from остается владелец почтового ящика. Вы можете программным способом задать в качестве значения свойства sender пользователя, получившего разрешения представителя для этого почтового ящика.

Проверка состояния получателя и экономия времени с помощью подсказок (ознакомительная версия)

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

Чтение сообщений с управлением форматом возвращаемого текста

Можно прочитать сообщение в почтовом ящике, указав его идентификатор:

GET /me/messages/AAMkADhMGAAA=

Или можно получать сообщения в определенной папке. Например, чтобы читать сообщения в папке "Черновики" пользователя, вошедшего в систему, укажите следующее:

GET /me/mailfolders('Drafts')

Текст сообщения Outlook может иметь либо формат HTML, либо текстовый формат. По умолчанию в отклике GET текст сообщения возвращается в формате HTML.

При получении сообщения вы можете задать указанный ниже заголовок запроса, чтобы система возвратила свойства body и uniqueBody в текстовом формате.

Prefer: outlook.body-content-type="text"

Чтобы получить текст сообщения в формате HTML, задайте указанный ниже заголовок или просто пропустите его.

Prefer: outlook.body-content-type="html"

Когда вы указываете какой-либо заголовок, успешный отклик будет включать соответствующий заголовок Preference-Applied.

• Чтобы получить результат выполнения запроса в текстовом формате: Preference-Applied: outlook.body-content-type="text"
• Чтобы получить результат выполнения запроса в формате HTML: Preference-Applied: outlook.body-content-type="html"

Если текст сообщения имеет формат HTML, то по умолчанию прежде чем возвратить текст сообщения в отклике REST, Outlook удаляет весь потенциально небезопасный HTML-код (например, код JavaScript), внедренный в свойство body.

Чтобы получить все исходное содержимое в формате HTML, добавьте следующий заголовок HTTP-запроса:

Prefer: outlook.allow-unsafe-html

Интеграция с социальными жестами (ознакомительная версия)

@Упоминания — это уведомления для пользователей, о том, что их упомянули в сообщениях. С помощью ресурса mention приложения могут задавать и получать стандартный социальный жест в Интернете (префикс @) в письмах. Вы можете выполнить указанные ниже действия.

• Создавать @упоминания при составлении сообщений
• Получать все сообщения в почтовом ящике пользователя, содержащие @упоминание пользователя
• Получать все @упоминания в сообщении

Другие общие возможности

Используйте указанные ниже стандартные возможности, имеющиеся в объектах Microsoft Graph.

• Вы можете подписаться на уведомления об изменениях сообщений. Вы будете получать их при возникновении изменений одного или нескольких типов, например при создании или изменении сообщений.
• Отслеживание добавочных изменений сообщений в папке.
• Вы можете создавать открытые расширения или расширения схемы, чтобы добавлять пользовательские данные в экземпляры сообщений.
• Вы можете создавать расширенные свойства в экземплярах сообщений, чтобы хранить пользовательские данные для свойств MAPI Outlook, когда эти свойства еще недоступны в метаданных API Microsoft Graph.

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

• Зачем выполнять интеграцию с почтой Outlook?
• Получение содержимого MIME (предварительная версия)
• Получение общих сообщений
• Отправка сообщений Outlook от другого пользователя
• Получение неизменяемых идентификаторов для ресурсов Outlook
• Использование API почты и варианты использования в Microsoft Graph 1.0.