Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
Пространство имен: microsoft.graph
Обновление свойств объекта eventMessage.
Этот 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 | Характер данных в теле объекта. Обязательно. |
Текст запроса
В тексте запроса укажите значения для соответствующих полей, которые необходимо обновить. Предыдущие значения существующих свойств, не включенных в текст запроса, останутся прежними или будут повторно вычислены с учетом измененных значений других свойств. Для достижения оптимальной производительности не следует включать существующие значения, которые не изменились. Ниже перечислены свойства, доступные для записи и обновления.
| Свойство | Тип | Описание |
|---|---|---|
| categories | String | Категории, связанные с сообщением. |
| importance | String | Важность сообщения. Допустимые значения: Low, Normal, High. |
| isDeliveryReceiptRequested | Boolean | Указывает, запрашивается ли уведомление о прочтении сообщения. |
| isRead | Boolean | Указывает, прочитано ли сообщение. |
| isReadReceiptRequested | Boolean | Указывает, запрашивается ли уведомление о прочтении сообщения. |
Отклик
В случае успеха этот метод возвращает код отклика 200 OK и обновленный объект eventMessage в тексте отклика.
Пример
Запрос
Ниже показан пример запроса.
PATCH https://graph.microsoft.com/v1.0/me/messages/{id}
Content-type: application/json
{
"isRead": true,
}
Отклик
Ниже показан пример отклика. Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
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",
"meetingMessageType": "meetingMessageType-value"
}