Тип ресурса eventMessage

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

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

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

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

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

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

Методы

Метод	Возвращаемый тип	Описание
Получение объекта eventMessage	eventMessage	Считывание свойств и отношений объекта eventMessage.
Обновление	eventMessage	Обновление объекта eventMessage.
Удаление	Нет	Удаление объекта eventMessage.
copy	message	Копирование сообщения в папку.
createForward	message	Создание черновика пересылаемого сообщения. После этого вы сможете обновить или отправить черновик.
createReply	message	Создание черновика ответного сообщения. После этого вы сможете обновить или отправить черновик.
createReplyAll	message	Создание черновика сообщения для ответа всем пользователям. После этого вы сможете обновить или отправить черновик.
forward	Нет	Пересылка сообщения. После этого сообщение сохраняется в папке "Отправленные".
move	message	Перемещение сообщения в папку. При этом в целевой папке создается новая копия сообщения.
reply	Нет	Ответ отправителю сообщения. После этого сообщение сохраняется в папке "Отправленные".
replyAll	Нет	Ответ всем получателям сообщения. После этого сообщение сохраняется в папке "Отправленные".
send	Нет	Отправка ранее созданного черновика сообщения. После этого сообщение сохраняется в папке "Отправленные".
Вложения
Список вложений	Коллекция attachment	Получение всех файлов, вложенных в сообщение о событии.
Добавление вложения	attachment	Вложение в сообщение о событии нового файла путем публикации в коллекции вложений.
Открытые расширения
Создание открытого расширения	openTypeExtension	Создание открытого расширения и добавление настраиваемых свойств в новый или существующий экземпляр ресурса.
Получение открытого расширения	Коллекция openTypeExtension	Получение объекта или объектов открытого расширения, которые определяются по имени или полному имени.
Расширенные свойства
Создание однозначного расширенного свойства	eventMessage	Создание одного или нескольких расширенных свойств с одним значением в новом или существующем экземпляре eventMessage.
Получение eventMessage с расширенным свойством с одним значением	eventMessage	Получение экземпляров eventMessage, которые содержат расширенное свойство с одним значением, с помощью параметра $expand или $filter.
Создание расширенного свойства с несколькими значениями	eventMessage	Создание одного или нескольких расширенных свойств с несколькими значениями в новом или существующем экземпляре 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	Boolean	Значение 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"
}