Тип ресурса message
Пространство имен: microsoft.graph
Сообщение в mailFolder.
Максимальное число получателей, включенное в свойства toRecipients, ccRecipients и bccRecipients для одного сообщения электронной почты, отправляемого из почтового ящика Exchange Online, равно 500. Дополнительные сведения см. в разделе Ограничения на отправку.
Этот ресурс поддерживает:
- добавление собственных данных как настраиваемых заголовков сообщений Интернета. Добавляйте настраиваемые заголовки только при создании сообщения и выбирайте для них имя, начинающееся с "x-". После отправки сообщения вы не сможете изменить заголовки. Чтобы получить заголовки сообщения, примените параметр запроса
$select
в операции получения сообщения; - добавление собственных данных как настраиваемых свойств в виде расширений;
- подписку на уведомления об изменениях;
- отслеживание дополнений, удалений и обновлений с помощью запроса изменений (функция delta).
Методы
Метод | Тип возвращаемых данных | Описание |
---|---|---|
Список сообщений | Коллекция message | Получение всех сообщений в почтовом ящике пользователя, выполнившего вход (в том числе сообщений в папках "Удаленные" и "Несрочные"). |
Создание сообщения | message | Создание черновика нового сообщения. |
Получение сообщения | message | Считывание свойств и отношений объекта message. |
Обновление | message | Обновление объекта message. |
Удаление | Нет | Удаление объекта message. |
copy | Message | Копирование сообщения в папку. |
createForward | Message | Создание черновика пересылаемого сообщения. После этого вы сможете обновить или отправить черновик. |
createReply | Message | Создание черновика ответного сообщения. После этого вы сможете обновить или отправить черновик. |
createReplyAll | Message | Создание черновика сообщения для ответа всем пользователям. После этого вы сможете обновить или отправить черновик. |
delta | Коллекция объектов message | Получение набора сообщений, которые были добавлены, удалены или обновлены в указанной папке. |
forward | Нет | Пересылка сообщения. После этого сообщение сохраняется в папке "Отправленные". |
move | Message | Перемещение сообщения в папку. При этом в целевой папке создается новая копия сообщения. |
reply | Нет | Ответ отправителю сообщения. После этого сообщение сохраняется в папке "Отправленные". |
replyAll | Нет | Ответ всем получателям сообщения. После этого сообщение сохраняется в папке "Отправленные". |
send | Нет | Отправка ранее созданного черновика сообщения. После этого сообщение сохраняется в папке "Отправленные". |
Вложения | ||
Список вложений | Коллекция 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:image001.jpg@01D26CD8.6C05F070"> . |
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 с помощью открытых расширений
- Добавление пользовательских данных в группы с помощью расширений схемы
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе:Отправить и просмотреть отзыв по