Поделиться через


Обновление сообщения

Пространство имен: microsoft.graph

Обновление свойств объекта сообщения.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

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

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) Mail.ReadWrite
Делегированные (личная учетная запись Майкрософт) Mail.ReadWrite
Для приложений Mail.ReadWrite

HTTP-запрос

PATCH /me/messages/{id}
PATCH /users/{id | userPrincipalName}/messages/{id}
PATCH /me/mailFolders/{id}/messages/{id}
PATCH /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}

Заголовки запросов

Имя Тип Описание
Authorization string Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type string Характер данных в теле объекта. Обязательно.

Текст запроса

В тексте запроса укажите значения для соответствующих полей, которые необходимо обновить. Предыдущие значения существующих свойств, не включенных в текст запроса, останутся прежними или будут повторно вычислены с учетом измененных значений других свойств. Для достижения оптимальной производительности не следует включать существующие значения, которые не изменились. Могут быть обновлены перечисленные ниже свойства.

Свойство Тип Описание
bccRecipients Recipient Получатели скрытой копии сообщения.
body ItemBody Текст сообщения. Можно обновить, только если параметр IsDraft имеет значение true.
categories Коллекция String Категории, сопоставленные с сообщением.
ccRecipients Коллекция объектов Recipient Получатели копии сообщения.
flag followupFlag Значение флага, которое указывает статус, дату начала, дату выполнения или дату завершения сообщения.
from Recipient Владелец почтового ящика и отправитель сообщения. Должно соответствовать фактически используемому почтовому ящику.
importance String Важность сообщения. Допустимые значения: Low, Normal, High.
inferenceClassification String Классификация сообщения для пользователя на основании подразумеваемой релевантности или важности либо явного переопределения. Допустимые значения: focused или other.
internetMessageId String Идентификатор сообщения в формате, установленном документом RFC2822. Можно обновить, только если параметр IsDraft имеет значение true.
isDeliveryReceiptRequested Boolean Указывает, запрашивается ли уведомление о прочтении сообщения.
isRead Boolean Указывает, прочитано ли сообщение.
isReadReceiptRequested Boolean Указывает, запрашивается ли уведомление о прочтении сообщения.
multiValueExtendedProperties Коллекция multiValueLegacyExtendedProperty Коллекция многозначных расширенных свойств, определенных для сообщения. Допускается значение null.
replyTo Коллекция объектов Recipient Электронные адреса, которые необходимо использовать при ответе. Можно обновить, только если параметр IsDraft имеет значение true.
sender Recipient Учетная запись, которая фактически используется для создания сообщения. Можно изменять при отправке сообщения из общего почтового ящика или отправке сообщения в качестве представителя. В любом случае значение должно соответствовать фактически используемому почтовому ящику.
singleValueExtendedProperties Коллекция singleValueLegacyExtendedProperty Коллекция однозначных расширенных свойств, определенных для сообщения. Допускается значение null.
subject String Тема сообщения. Можно обновить, только если параметр IsDraft имеет значение true.
toRecipients Коллекция объектов Recipient Получатели сообщения, указанные в поле "Кому".

Так как ресурс message поддерживает расширения, с помощью операции PATCH можно добавлять, обновлять или удалять собственные данные, касающиеся определенных приложений, в настраиваемых свойствах расширения в существующем экземпляре message.

Отклик

При успешном выполнении этот метод возвращает код отклика 200 OK и обновленный объект message в тексте отклика.

Пример

Запрос

Ниже показан пример запроса.

PATCH https://graph.microsoft.com/v1.0/me/messages/{id}
Content-type: application/json

{
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "inferenceClassification": "other"
}
Отклик

Ниже показан пример отклика. Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-type: application/json

{
  "receivedDateTime": "datetime-value",
  "sentDateTime": "datetime-value",
  "hasAttachments": true,
  "subject": "subject-value",
  "body": {
    "contentType": "",
    "content": "content-value"
  },
  "bodyPreview": "bodyPreview-value",
  "inferenceClassification": "other"
}