Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
Пространство имен: 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"
}