Тип ресурса messagemessage resource type

Сообщение в mailFolder.A message in a mailFolder.

Максимальное число получателей, включенное в свойства toRecipients, ccRecipients и bccRecipients для одного сообщения электронной почты, отправляемого из почтового ящика Exchange Online, равно 500.The maximum total number of recipients included in the toRecipients, ccRecipients, and bccRecipients properties for a single email message sent from an Exchange Online mailbox is 500. Дополнительные сведения см. в разделе Ограничения на отправку.For more information, see Recipient limits.

Этот ресурс поддерживает:This resource supports:

  • добавление собственных данных как настраиваемых заголовков сообщений Интернета.Adding your own data as custom Internet message headers. Добавляйте настраиваемые заголовки только при создании сообщения и выбирайте для них имя, начинающееся с "x-".Add custom headers only when creating a message, and name them starting with "x-". После отправки сообщения невозможно изменить заголовки.Once the message has been sent, you cannot modify the headers. Чтобы получить заголовки сообщения, примените параметр запроса $select в операции получения сообщения;To get the headers of a message, apply the $select query parameter in a get message operation.
  • добавление собственных данных как настраиваемых свойств в виде расширений;Adding your own data as custom properties as extensions.
  • подписку на уведомления об изменениях;Subscribing to change notifications.
  • отслеживание дополнений, удалений и обновлений с помощью запроса изменений (функция delta).Using delta query to track incremental additions, deletions, and updates, by providing a delta function.

МетодыMethods

МетодMethod Возвращаемый типReturn Type ОписаниеDescription
Список сообщенийList messages Коллекция messagemessage collection Получение всех сообщений в почтовом ящике пользователя, выполнившего вход (в том числе сообщений в папках "Удаленные" и "Несрочные").Get all the messages in the signed-in user's mailbox (including the Deleted Items and Clutter folders).
Создание сообщенияCreate message messagemessage Создание черновика нового сообщения.Create a draft of a new message.
Получение сообщенияGet message messagemessage Считывание свойств и отношений объекта message.Read properties and relationships of message object.
ОбновлениеUpdate messagemessage Обновление объекта message.Update message object.
УдалениеDelete НетNone Удаление объекта message.Delete message object.
copycopy MessageMessage Копирование сообщения в папку.Copy a message to a folder.
createForwardcreateForward MessageMessage Создание черновика пересылаемого сообщения. После этого вы сможете обновить или отправить черновик.Create a draft of the Forward message. You can then update or send the draft.
createReplycreateReply MessageMessage Создание черновика ответного сообщения. После этого вы сможете обновить или отправить черновик.Create a draft of the Reply message. You can then update or send the draft.
createReplyAllcreateReplyAll MessageMessage Создание черновика сообщения для ответа всем пользователям. После этого вы сможете обновить или отправить черновик.Create a draft of the Reply All message. You can then update or send the draft.
deltadelta Коллекция объектов messagemessage collection Получение списка сообщений, которые были добавлены в указанную папку, обновлены в ней или удалены из нее.Get a set of messages that have been added, deleted, or updated in a specified folder.
forwardforward НетNone Пересылка сообщения. После этого сообщение сохраняется в папке "Отправленные".Forward a message. The message is then saved in the Sent Items folder.
movemove MessageMessage Перемещение сообщения в папку. При этом в целевой папке создается новая копия сообщения.Move the message to a folder. This creates a new copy of the message in the destination folder.
replyreply НетNone Ответ отправителю сообщения. После этого сообщение сохраняется в папке "Отправленные".Reply to the sender of a message. The message is then saved in the Sent Items folder.
replyAllreplyAll НетNone Ответ всем получателям сообщения. После этого сообщение сохраняется в папке "Отправленные".Reply to all recipients of a message. The message is then saved in the Sent Items folder.
sendsend НетNone Отправка ранее созданного черновика сообщения. После этого сообщение сохраняется в папке "Отправленные".Sends a previously created message draft. The message is then saved in the Sent Items folder.
ВложенияAttachments
Список вложенийList attachments Коллекция AttachmentAttachment collection Получает все вложения сообщения.Gets all attachments on a message.
Добавление вложенияAdd attachment AttachmentAttachment Добавление нового вложения к сообщению путем публикации в коллекции вложений.Add a new attachment to a message by posting to the attachments collection.
Открытые расширенияOpen extensions
Создание открытого расширенияCreate open extension openTypeExtensionopenTypeExtension Создание открытого расширения и добавление настраиваемых свойств в новый или существующий экземпляр ресурса.Create an open extension and add custom properties in a new or existing instance of a resource.
Получение открытого расширенияGet open extension Коллекция openTypeExtensionopenTypeExtension collection Получение объектов открытого расширения, которые определяются по имени или полному имени.Get an open extension object or objects identified by name or fully qualified name.
Расширения схемыSchema extensions
Добавление значений расширений для схемыAdd schema extension values Создание определения расширения схемы и его дальнейшее использование для добавления в ресурс введенных пользовательских данных.Create a schema extension definition and then use it to add custom typed data to a resource.
Расширенные свойстваExtended properties
Создание однозначного расширенного свойстваCreate single-value extended property messagemessage Создание одного или нескольких расширенных свойств с одним значением в новом или существующем сообщении.Create one or more single-value extended properties in a new or existing message.
Получение сообщения с однозначным расширенным свойствомGet message with single-value extended property messagemessage Получение сообщений, которые содержат однозначное расширенное свойство, с помощью $expand или $filter.Get messages that contain a single-value extended property by using $expand or $filter.
Создание многозначного расширенного свойстваCreate multi-value extended property messagemessage Создание одного или нескольких многозначных расширенных свойств в новом или существующем сообщении.Create one or more multi-value extended properties in a new or existing message.
Получение сообщения с многозначным расширенным свойствомGet message with multi-value extended property messagemessage Получение сообщения, которое содержит многозначное расширенное свойство, с помощью $expand.Get a message that contains a multi-value extended property by using $expand.

СвойстваProperties

СвойствоProperty ТипType ОписаниеDescription
bccRecipientsbccRecipients Коллекция recipientrecipient collection Получатели скрытой копии сообщения.The Bcc: recipients for the message.
bodybody itemBodyitemBody Текст сообщения.The body of the message. В формате HTML или текстовом формате.It can be in HTML or text format. Сведения о надежном формате HTML в тексте сообщения.Find out about safe HTML in a message body.
bodyPreviewbodyPreview StringString Первые 255 символов в тексте сообщения. В текстовом формате.The first 255 characters of the message body. It is in text format.
categoriescategories Коллекция StringString collection Категории, сопоставленные с сообщением.The categories associated with the message.
ccRecipientsccRecipients Коллекция recipientrecipient collection Получатели копии сообщения.The Cc: recipients for the message.
changeKeychangeKey StringString Версия сообщения.The version of the message.
conversationIdconversationId StringString Идентификатор беседы, к которой принадлежит электронное сообщение.The ID of the conversation the email belongs to.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Дата и время создания сообщения.The date and time the message was created.
flagflag followupFlagfollowupFlag Значение флага, которое указывает статус, дату начала, дату выполнения или дату завершения сообщения.The flag value that indicates the status, start date, due date, or completion date for the message.
fromfrom recipientrecipient Владелец почтового ящика и отправитель сообщения.The mailbox owner and sender of the message. Значение должно соответствовать фактически используемому почтовому ящику.The value must correspond to the actual mailbox used. Дополнительные сведения о задании свойств from и sender сообщения.Find out more about setting the from and sender properties of a message.
hasAttachmentshasAttachments BooleanBoolean Указывает на наличие вложений в сообщении. Это свойство не включает встроенные вложения, поэтому, если сообщение содержит только встроенные вложения, это свойство имеет значение false. Чтобы проверить наличие встроенных вложений, проанализируйте свойство body на наличие атрибута src, например <IMG src="cid:image001.jpg@01D26CD8.6C05F070">.Indicates whether the message has attachments. This property doesn't include inline attachments, so if a message contains only inline attachments, this property is false. To verify the existence of inline attachments, parse the body property to look for a src attribute, such as <IMG src="cid:image001.jpg@01D26CD8.6C05F070">.
idid StringString Уникальный идентификатор сообщения (обратите внимание, что это значение может меняться при перемещении и изменении сообщения).Unique identifier for the message (note that this value may change if a message is moved or altered)
importanceimportance importanceimportance Важность сообщения: Low, Normal, High.The importance of the message: Low, Normal, High.
inferenceClassificationinferenceClassification inferenceClassificationTypeinferenceClassificationType Классификация сообщения для пользователя на основании подразумеваемой релевантности или важности либо явного переопределения.The classification of the message for the user, based on inferred relevance or importance, or on an explicit override. Допустимые значения: focused или other.The possible values are: focused or other.
internetMessageHeadersinternetMessageHeaders Коллекция internetMessageHeaderinternetMessageHeader collection Коллекция заголовков сообщений, определенных документом RFC5322.A collection of message headers defined by RFC5322. Набор содержит заголовки сообщений, указывающие сетевой путь, пройденный сообщением от отправителя до получателя.The set includes message headers indicating the network path taken by a message from the sender to the recipient. Он также может содержать настраиваемые заголовки сообщений, содержащие данные приложения для сообщения.It can also contain custom message headers that hold app data for the message.

Возвращается только при применении параметра запроса $select.Returned only on applying a $select query option. Только для чтения.Read-only.
internetMessageIdinternetMessageId StringString Идентификатор сообщения в формате, установленном документом RFC2822.The message ID in the format specified by RFC2822.
isDeliveryReceiptRequestedisDeliveryReceiptRequested BooleanBoolean Указывает, запрашивается ли уведомление о прочтении сообщения.Indicates whether a read receipt is requested for the message.
isDraftisDraft ЛогическоеBoolean Указывает, является ли сообщение черновиком. Сообщение считается черновиком, если оно еще не отправлено.Indicates whether the message is a draft. A message is a draft if it hasn't been sent yet.
isReadisRead BooleanBoolean Указывает, прочитано ли сообщение.Indicates whether the message has been read.
isReadReceiptRequestedisReadReceiptRequested BooleanBoolean Указывает, запрашивается ли уведомление о прочтении сообщения.Indicates whether a read receipt is requested for the message.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Дата и время последнего изменения сообщения.The date and time the message was last changed.
parentFolderIdparentFolderId StringString Уникальный идентификатор родительского ресурса mailFolder для сообщения.The unique identifier for the message's parent mailFolder.
receivedDateTimereceivedDateTime DateTimeOffsetDateTimeOffset Дата и время получения сообщения.The date and time the message was received.
replyToreplyTo Коллекция recipientrecipient collection Электронные адреса, которые необходимо использовать при ответе.The email addresses to use when replying.
sendersender recipientrecipient Учетная запись, которая фактически используется для создания сообщения.The account that is actually used to generate the message. В большинстве случаев это значение совпадает со значением свойства from.In most cases, this value is the same as the from property. Этому свойству можно присвоить другое значение при отправке сообщения из общего почтового ящика или отправке сообщения в качестве представителя.You can set this property to a different value when sending a message from a shared mailbox, or sending a message as a delegate. В любом случае значение должно соответствовать фактически используемому почтовому ящику.In any case, the value must correspond to the actual mailbox used. Дополнительные сведения о задании свойств from и sender сообщения.Find out more about setting the from and sender properties of a message.
sentDateTimesentDateTime DateTimeOffsetDateTimeOffset Дата и время отправки сообщения.The date and time the message was sent.
subjectsubject StringString Тема сообщения.The subject of the message.
toRecipientstoRecipients Коллекция recipientrecipient collection Получатели сообщения, указанные в поле "Кому".The To: recipients for the message.
uniqueBodyuniqueBody itemBodyitemBody Часть текста сообщения, которая уникальна для текущего сообщения. Экземпляр uniqueBody не возвращается по умолчанию, но может быть получен для заданного сообщения с помощью запроса ?$select=uniqueBody. В формате HTML или текстовом формате.The part of the body of the message that is unique to the current message. uniqueBody is not returned by default but can be retrieved for a given message by use of the ?$select=uniqueBody query. It can be in HTML or text format.
webLinkwebLink StringString URL-адрес для открытия сообщения в Outlook Web App.The URL to open the message in Outlook Web App.

Чтобы изменить способ отображения сообщения, можно добавить аргумент ispopout в конце URL-адреса. Если аргумент ispopout отсутствует или для него задано значение 1, то сообщение откроется во всплывающем окне. Если для аргумента ispopout задано значение 0, то в браузере сообщение будет отображаться в области просмотра Outlook Web App.You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, then the browser will show the message in the Outlook Web App review pane.

Сообщение откроется в браузере, если вы вошли в свой почтовый ящик с помощью Outlook Web App. Если вход с помощью браузера еще не выполнен, вам будет предложено войти.The message will open in the browser if you are logged in to your mailbox via Outlook Web App. You will be prompted to login if you are not already logged in with the browser.

Доступ к этому URL-адресу можно получить из объекта iFrame.This URL can be accessed from within an iFrame.

ОтношенияRelationships

ОтношениеRelationship ТипType ОписаниеDescription
attachmentsattachments Коллекция attachment attachment collection Вложения fileAttachment и itemAttachment для сообщения.The fileAttachment and itemAttachment attachments for the message.
extensionsextensions Коллекция extensionextension collection Коллекция открытых расширений, определенных для сообщения.The collection of open extensions defined for the message. Допускается значение null.Nullable.
multiValueExtendedPropertiesmultiValueExtendedProperties Коллекция multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection Коллекция многозначных расширенных свойств, определенных для сообщения.The collection of multi-value extended properties defined for the message. Допускается значение null.Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties Коллекция singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection Коллекция однозначных расширенных свойств, определенных для сообщения.The collection of single-value extended properties defined for the message. Допускается значение null.Nullable.

Описание в формате JSONJSON representation

Ниже этот ресурс представлен в формате JSON.Here is a JSON representation of the resource

{
  "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",
  "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"}]
}

См. такжеSee also