Тип ресурса message
Пространство имен: microsoft.graph
Сообщение в mailFolder.
Максимальное число получателей, включенное в свойства toRecipients, ccRecipients и bccRecipients для одного сообщения электронной почты, отправляемого из почтового ящика Exchange Online, равно 500. Дополнительные сведения см. в разделе Ограничения на отправку.
Этот ресурс поддерживает:
- добавление собственных данных как настраиваемых заголовков сообщений Интернета. Добавляйте настраиваемые заголовки только при создании сообщения и выбирайте для них имя, начинающееся с "x-". После отправки сообщения вы не сможете изменить заголовки. Чтобы получить заголовки сообщения, примените параметр запроса
$select
в операции получения сообщения; - добавление собственных данных как настраиваемых свойств в виде расширений;
- подписку на уведомления об изменениях;
- отслеживание дополнений, удалений и обновлений с помощью запроса изменений (функция delta).
Методы
Метод | Тип возвращаемых данных | Описание |
---|---|---|
Список сообщений | Коллекция message | Получение всех сообщений в почтовом ящике пользователя, выполнившего вход (в том числе сообщений в папках "Удаленные" и "Несрочные"). |
Создание черновика сообщения | message | Создание черновика нового сообщения. |
Получение сообщения | message | Считывание свойств и отношений объекта message. |
Обновление сообщения | message | Обновление объекта message. |
Удалить сообщение | Нет | Удаление объекта message. |
Копирование сообщения | Message | Копирование сообщения в папку. |
Создание черновика для пересылки сообщения | Сообщение | Создание черновика пересылаемого сообщения. После этого вы сможете обновить или отправить черновик. |
Создание черновика для ответа | Сообщение | Создание черновика ответного сообщения. После этого вы сможете обновить или отправить черновик. |
Создание черновика для ответа на все | Сообщение | Создание черновика сообщения для ответа всем пользователям. После этого вы сможете обновить или отправить черновик. |
Получение дельты сообщения | Коллекция message | Получение набора сообщений, которые были добавлены, удалены или обновлены в указанной папке. |
Пересылка сообщения | Нет | Пересылка сообщения. После этого сообщение сохраняется в папке "Отправленные". |
Переместить сообщение | Сообщение | Перемещение сообщения в папку. При этом в целевой папке создается новая копия сообщения. |
Ответ на сообщение | Нет | Ответ отправителю сообщения. После этого сообщение сохраняется в папке "Отправленные". |
Ответить всем на сообщение | Нет | Ответ всем получателям сообщения. После этого сообщение сохраняется в папке "Отправленные". |
Отправка черновика сообщения | Нет | Отправка ранее созданного черновика сообщения. После этого сообщение сохраняется в папке "Отправленные". |
Вложения | ||
Список вложений | Коллекция Attachment | Получает все вложения сообщения. |
Добавление вложения | Attachment | Добавление нового вложения к сообщению путем публикации в коллекции вложений. |
Открытые расширения | ||
Создание открытого расширения | openTypeExtension | Создание открытого расширения и добавление настраиваемых свойств в новый или существующий экземпляр ресурса. |
Получение открытого расширения | Коллекция openTypeExtension | Получение объекта или объектов открытого расширения, которые определяются по имени или полному имени. |
Расширенные свойства | ||
Создание однозначного свойства | message | Создание одного или нескольких расширенных свойств с одним значением в новом или существующем сообщении. |
Получение однозначного свойства | message | Получение сообщений, которые содержат однозначное расширенное свойство, с помощью $expand или $filter . |
Создание свойства с несколькими значениями | message | Создание одного или нескольких многозначных расширенных свойств в новом или существующем сообщении. |
Получение свойства с несколькими значениями | message | Получение сообщения, которое содержит многозначное расширенное свойство, с помощью $expand . |
Свойства
Свойство | Тип | Описание |
---|---|---|
bccRecipients | Коллекция recipient | Получатели скрытой копии сообщения. |
body | itemBody | Текст сообщения. В формате HTML или текстовом формате. Сведения о надежном формате HTML в тексте сообщения. |
bodyPreview | String | Первые 255 символов в тексте сообщения. В текстовом формате. |
ccRecipients | Коллекция recipient | Получатели копии сообщения. |
changeKey | String | Версия сообщения. |
conversationId | String | Идентификатор беседы, к которой принадлежит электронное сообщение. |
conversationIndex | Edm.Binary | Указывает место сообщения в беседе. |
createdDateTime | DateTimeOffset | Дата и время создания сообщения. Сведения о времени и дате представлены в формате ISO 8601 (всегда используется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . |
flag | followupFlag | Значение флага, которое указывает статус, дату начала, дату выполнения или дату завершения сообщения. |
from | recipient | Владелец почтового ящика, из которого отправлено сообщение. В большинстве случаев это значение совпадает со свойством sender, кроме сценариев предоставления общего доступа или делегирования. Значение должно соответствовать фактически используемому почтовому ящику. Дополнительные сведения о задании свойств from и sender сообщения. |
hasAttachments | Boolean | Указывает на наличие вложений в сообщении. Это свойство не включает встроенные вложения, поэтому, если сообщение содержит только встроенные вложения, это свойство имеет значение false. Чтобы проверить наличие встроенных вложений, выполните синтаксический анализ свойства body для поиска атрибута src , например <IMG src="cid:[email protected]"> . |
id | String | Уникальный идентификатор сообщения.
По умолчанию это значение изменяется при перемещении элемента из одного контейнера (например, папки или календаря) в другой. Чтобы изменить это поведение, используйте заголовок Prefer: IdType="ImmutableId" . Дополнительные сведения см. в статье Получение неизменяемых идентификаторов для ресурсов Outlook. Только для чтения. |
importance | importance | Важность сообщения. Возможные значения: low , normal и high . |
inferenceClassification | inferenceClassificationType | Классификация сообщения для пользователя на основании подразумеваемой релевантности или важности либо явного переопределения. Допустимые значения: focused или other . |
internetMessageHeaders | Коллекция internetMessageHeader | Коллекция заголовков сообщений, определенных документом RFC5322. Набор содержит заголовки сообщений, указывающие сетевой путь, пройденный сообщением от отправителя до получателя. Он также может содержать настраиваемые заголовки сообщений, содержащие данные приложения для сообщения. Возвращается только при применении параметра запроса $select . Только для чтения. |
internetMessageId | String | Идентификатор сообщения в формате, установленном документом RFC2822. |
isDeliveryReceiptRequested | Boolean | Указывает, запрашивается ли уведомление о прочтении сообщения. |
isDraft | Логическое | Указывает, является ли сообщение черновиком. Сообщение считается черновиком, если оно еще не отправлено. |
isRead | Boolean | Указывает, прочитано ли сообщение. |
isReadReceiptRequested | Boolean | Указывает, запрашивается ли уведомление о прочтении сообщения. |
lastModifiedDateTime | DateTimeOffset | Дата и время последнего изменения сообщения. Сведения о времени и дате представлены в формате ISO 8601 (всегда используется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . |
parentFolderId | String | Уникальный идентификатор родительского ресурса mailFolder для сообщения. |
receivedDateTime | DateTimeOffset | Дата и время получения сообщения. Сведения о времени и дате представлены в формате ISO 8601 (всегда используется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . |
replyTo | Коллекция recipient | Электронные адреса, которые необходимо использовать при ответе. |
sender | recipient | Учетная запись, которая фактически используется для создания сообщения. В большинстве случаев это значение совпадает со значением свойства from. Этому свойству можно присвоить другое значение при отправке сообщения из общего почтового ящика, для общего календаря или в качестве делегата. В любом случае значение должно соответствовать фактически используемому почтовому ящику. Дополнительные сведения о задании свойств from и sender сообщения. |
sentDateTime | DateTimeOffset | Дата и время отправки сообщения. Сведения о времени и дате представлены в формате ISO 8601 (всегда используется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z . |
subject | String | Тема сообщения. |
toRecipients | Коллекция recipient | Получатели сообщения, указанные в поле "Кому". |
uniqueBody | itemBody | Часть текста сообщения, которая уникальна для текущего сообщения.
uniqueBody не возвращается по умолчанию, но его можно получить для заданного ?$select=uniqueBody сообщения с помощью запроса. В формате HTML или текстовом формате. |
webLink | String | URL-адрес для открытия сообщения в Outlook в Интернете. Чтобы изменить способ отображения сообщения, можно добавить аргумент ispopout в конце URL-адреса. Если аргумент ispopout отсутствует или для него задано значение 1, то сообщение откроется во всплывающем окне. Если параметр ispopout имеет значение 0, браузер отображает сообщение в области Outlook в Интернете. Сообщение откроется в браузере, если вы вошли в почтовый ящик через Outlook в Интернете. Если вы еще не вошли в браузер, вам будет предложено войти в систему. Доступ к этому URL-адресу невозможно получить из объекта iFrame. |
Связи
Связь | Тип | Описание |
---|---|---|
attachments | Коллекция attachment | Вложения fileAttachment и itemAttachment для сообщения. |
extensions | Коллекция extension | Коллекция открытых расширений, определенных для сообщения. Допускается значение null. |
multiValueExtendedProperties | Коллекция multiValueLegacyExtendedProperty | Коллекция многозначных расширенных свойств, определенных для сообщения. Допускается значение null. |
singleValueExtendedProperties | Коллекция singleValueLegacyExtendedProperty | Коллекция однозначных расширенных свойств, определенных для сообщения. Допускается значение null. |
Представление JSON
В следующем представлении JSON показан тип ресурса.
{
"bccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"body": {"@odata.type": "microsoft.graph.itemBody"},
"bodyPreview": "string",
"categories": ["string"],
"ccRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"changeKey": "string",
"conversationId": "string",
"conversationIndex": "String (binary)",
"createdDateTime": "String (timestamp)",
"flag": {"@odata.type": "microsoft.graph.followupFlag"},
"from": {"@odata.type": "microsoft.graph.recipient"},
"hasAttachments": true,
"id": "string (identifier)",
"importance": "String",
"inferenceClassification": "String",
"internetMessageHeaders": [{"@odata.type": "microsoft.graph.internetMessageHeader"}],
"internetMessageId": "String",
"isDeliveryReceiptRequested": true,
"isDraft": true,
"isRead": true,
"isReadReceiptRequested": true,
"lastModifiedDateTime": "String (timestamp)",
"parentFolderId": "string",
"receivedDateTime": "String (timestamp)",
"replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
"sender": {"@odata.type": "microsoft.graph.recipient"},
"sentDateTime": "String (timestamp)",
"subject": "string",
"toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
"uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
"webLink": "string",
"attachments": [{"@odata.type": "microsoft.graph.attachment"}],
"extensions": [{"@odata.type": "microsoft.graph.extension"}],
"multiValueExtendedProperties": [{"@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty"}],
"singleValueExtendedProperties": [{"@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty"}]
}
Связанные материалы
- Получение параметров почтового ящика
- Обновление параметров почтового ящика
- Отслеживание изменений данных Microsoft Graph с помощью запроса изменений
- Получение добавочных изменений сообщений в папке
- Добавление пользовательских данных в ресурсы с помощью расширений
- Добавление пользовательских данных в ресурсы user с помощью открытых расширений
- Добавление пользовательских данных в группы с помощью расширений схемы