Поделиться через


Тип ресурса eventMessage

Пространство имен: microsoft.graph

Сообщение, которое представляет собой приглашение на собрание, уведомление об отмене или ответ (принятие, предварительное принятие или отклонение).

Объект eventMessage является производным от объекта message. eventMessage — это базовый тип для eventMessageRequest и eventMessageResponse. Свойство meetingMessageType определяет тип сообщения о событии.

Когда организатор или приложение отправляет приглашение на собрание, приглашение на собрание поступает в почтовый ящик приглашенного в качестве экземпляра eventMessage с типом meetingMessageTypeобъекта meetingRequest. Кроме того, Outlook автоматически создает экземпляр события в календаре приглашенного с предварительным значением свойства showAs.

Чтобы получить свойства связанного события в почтовом ящике приглашенного, приложение может использовать свойство навигации по событиямeventMessage, как показано в этом примере сообщения о событии get. Приложение также может отвечать на событие от имени приглашенного программным способом, принимая, предварительно принимая или отклоивая событие.

Помимо приглашения на собрание, экземпляр eventMessage можно найти в почтовом ящике приглашенного в результате отмены собрания организатором мероприятия или в почтовом ящике организатора в результате ответа приглашенного на приглашение на собрание. Приложение может предпринимать с сообщениями о событиях те же действия, что и с обычными сообщения (с небольшими отличиями).

Методы

Метод Возвращаемый тип Описание
Вывод сообщения о событии eventMessage Считывание свойств и отношений объекта eventMessage.
Обновление сообщения о событии eventMessage Обновление объекта eventMessage.
Удалить сообщение Нет Удаление объекта eventMessage.
Копирование сообщения message Копирование сообщения в папку.
Create черновик для пересылки сообщения message Создание черновика пересылаемого сообщения. После этого вы сможете обновить или отправить черновик.
Create черновик ответа message Создание черновика ответного сообщения. После этого вы сможете обновить или отправить черновик.
Create черновик, чтобы ответить всем message Создание черновика сообщения для ответа всем пользователям. После этого вы сможете обновить или отправить черновик.
Пересылка сообщения Нет Пересылка сообщения. После этого сообщение сохраняется в папке "Отправленные".
Переместить сообщение message Перемещение сообщения в папку. При этом в целевой папке создается новая копия сообщения.
Ответ на сообщение Нет Ответ отправителю сообщения. После этого сообщение сохраняется в папке "Отправленные".
Ответить всем на сообщение Нет Ответ всем получателям сообщения. После этого сообщение сохраняется в папке "Отправленные".
Отправка черновика сообщения Нет Отправка ранее созданного черновика сообщения. После этого сообщение сохраняется в папке "Отправленные".
Вложения
Список вложений Коллекция attachment Получение всех файлов, вложенных в сообщение о событии.
Добавление вложения attachment Вложение в сообщение о событии нового файла путем публикации в коллекции вложений.
Открытые расширения
Создание открытого расширения openTypeExtension Создание открытого расширения и добавление настраиваемых свойств в новый или существующий экземпляр ресурса.
Получение открытого расширения Коллекция openTypeExtension Получение объекта или объектов открытого расширения, которые определяются по имени или полному имени.
Расширенные свойства
Создание однозначного свойства eventMessage Создание одного или нескольких расширенных свойств с одним значением в новом или существующем экземпляре eventMessage.
Получение однозначного свойства eventMessage Получение экземпляров eventMessage, которые содержат расширенное свойство с одним значением, с помощью параметра $expand или $filter.
Create многозначное свойство eventMessage Создание одного или нескольких расширенных свойств с несколькими значениями в новом или существующем экземпляре eventMessage.
Получение свойства с несколькими значениями eventMessage Получение eventMessage, которое содержит расширенное свойство с несколькими значениями, с помощью параметра $expand.

Свойства

Свойство Тип Описание
bccRecipients Коллекция recipient Получатели скрытой копии сообщения.
body itemBody Текст сообщения. В формате HTML или текстовом формате.
bodyPreview String Первые 255 символов в тексте сообщения. В текстовом формате.
categories Коллекция String Категории, сопоставленные с сообщением.
ccRecipients Коллекция recipient Получатели копии сообщения.
changeKey String Версия сообщения.
conversationId String Идентификатор беседы, к которой принадлежит электронное сообщение.
conversationIndex Edm.Binary Указывает место сообщения в беседе.
createdDateTime DateTimeOffset Дата и время создания сообщения.
flag followupFlag Значение флага, которое указывает статус, дату начала, дату выполнения или дату завершения сообщения.
from recipient Владелец почтового ящика, из которого отправлено сообщение. В большинстве случаев это значение совпадает со свойством sender, кроме сценариев предоставления общего доступа или делегирования. Значение должно соответствовать фактически используемому почтовому ящику. Дополнительные сведения о задании свойств from и sender сообщения.
hasAttachments Boolean Указывает на наличие вложений в сообщении.
id String Уникальный идентификатор сообщения о событии. По умолчанию это значение изменяется при перемещении элемента из одного контейнера (например, папки или календаря) в другой. Чтобы изменить это поведение, используйте заголовок Prefer: IdType="ImmutableId". Дополнительные сведения см. в статье Получение неизменяемых идентификаторов для ресурсов Outlook. Только для чтения.
importance String Важность сообщения: low, normal, high.
inferenceClassification String Возможные значения: focused, other.
internetMessageHeaders Коллекция internetMessageHeader Коллекция заголовков сообщений, установленных по RFC 5322, которые содержат информацию о маршруте прохождения сообщения. Только для чтения.
internetMessageId String Идентификатор сообщения в формате, установленном документом RFC2822.
isDelegated Логический Значение true, если этот запрос на собрание доступен делегату, в противном случае — значение false. Значение по умолчанию: false.
isDeliveryReceiptRequested Boolean Указывает, запрашивается ли уведомление о прочтении сообщения.
isDraft Логическое Указывает, является ли сообщение черновиком. Сообщение считается черновиком, если оно еще не отправлено.
isRead Boolean Указывает, прочитано ли сообщение.
isReadReceiptRequested Boolean Указывает, запрашивается ли уведомление о прочтении сообщения.
lastModifiedDateTime DateTimeOffset Дата и время последнего изменения сообщения.
meetingMessageType meetingMessageType Тип сообщения о событии: none, meetingRequest, meetingCancelled, meetingAccepted, meetingTenativelyAccepted, meetingDeclined.
parentFolderId String Уникальный идентификатор родительского ресурса mailFolder для сообщения.
receivedDateTime DateTimeOffset Дата и время получения сообщения.
replyTo Коллекция recipient Электронные адреса, которые необходимо использовать при ответе.
sender recipient Учетная запись, которая фактически используется для создания сообщения. В большинстве случаев это значение совпадает со значением свойства from. Этому свойству можно присвоить другое значение при отправке сообщения из общего почтового ящика, для общего календаря или в качестве делегата. В любом случае значение должно соответствовать фактически используемому почтовому ящику. Дополнительные сведения о задании свойств from и sender сообщения.
sentDateTime DateTimeOffset Дата и время отправки сообщения.
subject String Тема сообщения.
toRecipients Коллекция recipient Получатели сообщения, указанные в поле "Кому".
uniqueBody itemBody Часть текста сообщения, которая является уникальной для текущего сообщения.
webLink String URL-адрес для открытия сообщения в Outlook в Интернете.

Чтобы изменить способ отображения сообщения, можно добавить аргумент ispopout в конце URL-адреса. Если аргумент ispopout отсутствует или для него задано значение 1, то сообщение откроется во всплывающем окне. Если для аргумента ispopout задано значение 0, то в браузере сообщение будет отображаться в области просмотра Outlook в Интернете.

Сообщение откроется в браузере, если вы вошли в свой почтовый ящик с помощью Outlook в Интернете. Если вход с помощью браузера еще не выполнен, вам будет предложено войти.

Доступ к этому URL-адресу невозможно получить из объекта iFrame.

Связи

Связь Тип Описание
attachments Коллекция attachment Только для чтения. Допускается значение null.
event event Событие, связанное с сообщением о событии. Для участников или ресурсов помещений предполагается, что помощник по ведению календаря настроен для автоматического обновления события в календаре, если поступают сообщения с приглашением на собрание. Свойство навигации. Только для чтения.
extensions Коллекция extension Коллекция открытых расширений, определенных для eventMessage. Только для чтения. Допускается значение null.
multiValueExtendedProperties Коллекция multiValueLegacyExtendedProperty Коллекция расширенных свойств с несколькими значениями, определенных для eventMessage. Только для чтения. Допускается значение null.
singleValueExtendedProperties Коллекция singleValueLegacyExtendedProperty Коллекция расширенных свойств с одним значением, определенных для eventMessage. Только для чтения. Допускается значение 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": "DateTimeOffset",
  "event": { "@odata.type": "microsoft.graph.event" },
  "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",
  "isDelegated": true,
  "isDeliveryReceiptRequested": true,
  "isDraft": true,
  "isRead": true,
  "isReadReceiptRequested": true,
  "lastModifiedDateTime": "DateTimeOffset",
  "meetingMessageType": "String",
  "parentFolderId": "string",
  "receivedDateTime": "DateTimeOffset",
  "replyTo": [{"@odata.type": "microsoft.graph.recipient"}],
  "sender": {"@odata.type": "microsoft.graph.recipient"},
  "sentDateTime": "DateTimeOffset",
  "subject": "string",
  "toRecipients": [{"@odata.type": "microsoft.graph.recipient"}],
  "uniqueBody": {"@odata.type": "microsoft.graph.itemBody"},
  "webLink": "string"
}