Тип ресурса event

  • Статья

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Событие в календаре ресурса user или стандартный календарь для ресурса group, представляющего группу Microsoft 365.

Максимальное количество участников в ресурсе event и максимальное количество получателей в ресурсе eventMessage, отправленном из почтового ящика Exchange Online, составляет 500. Дополнительные сведения см. в разделе Ограничения на отправку.

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

Примечание. Существует несколько незначительных различий в способе взаимодействия с календарями пользователей, календарями групп и их событиями:

  • В ресурсе calendarGroup можно упорядочить только календари пользователей.
  • Объекты attachment можно добавлять только в события календарей пользователей, но не в события календарей групп.
  • Outlook автоматически принимает все приглашения на собрания от имени группы. Вы можете принимать, предварительно принимать или отклонять приглашения на собрания только для пользовательских календарей.
  • Outlook не поддерживает напоминания о событиях группы. Напоминание можно отложить или отключить только для календарей пользователя.

Методы

Метод Возвращаемый тип Описание
Перечисление событий Коллекция Event Получение списка объектов event в почтовом ящике пользователя. В этом списке указаны единичные собрания и главные собрания в соответствующих сериях.
Создание события event Создание события путем записи в коллекцию экземпляров.
Получение события event Считывание свойств и отношений объекта event.
Обновление event Обновление объекта event.
Удаление Нет Удаление объекта event.
delta Коллекция объектов event Получение списка событий, которые были добавлены в calendarView (диапазон событий) основного календаря пользователя, обновлены в нем или удалены из него.
forward Нет Позволяет организатору или участнику собрания пересылать приглашение на собрание новому получателю.
cancel Нет Отправка сообщения об отмене от организатора всем участникам и отмена указанного собрания.
accept Нет Принятие указанного события в календаре пользователя.
tentativelyAccept Нет Принятие под вопросом указанного события в календаре пользователя.
decline Нет Отклонение приглашения на указанное событие в календаре пользователя.
dismissReminder Нет Отключение напоминания для указанного события в календаре пользователя.
snoozeReminder Нет Откладывание напоминания для указанного события в календаре пользователя на другое время.
Перечисление экземпляров Коллекция Event Получение коллекции объектов event.
Вложения
Список вложений Коллекция Attachment Получение всех вложений, добавленных к данным о событии.
Добавление вложения Attachment Добавление нового вложения к данным о событии путем публикации в коллекции вложений.
Открытые расширения
Создание открытого расширения openTypeExtension Создание открытого расширения и добавление настраиваемых свойств в новый или существующий ресурс.
Получение открытого расширения Коллекция объектов openTypeExtension Получение открытого расширения, определяемого именем расширения.
Расширения схемы
Добавление значений расширений для схемы Создание определения расширения схемы и его дальнейшее использование для добавления в ресурс введенных пользовательских данных.
Расширенные свойства
Создание расширенного свойства с одним значением event Создание одного или нескольких расширенных свойств с одним значением в новом или существующем событии.
Получение события с расширенным свойством с одним значением event Получение событий, которые содержат расширенное свойство с одним значением, с помощью параметра $expand или $filter.
Создание расширенного свойства с несколькими значениями event Создание одного или нескольких расширенных свойств с несколькими значениями в новом или существующем событии.
Получение события с расширенным свойством с несколькими значениями event Получение события, которое содержит расширенное свойство с несколькими значениями, с помощью параметра $expand.

Свойства

Свойство Тип Описание
allowNewTimeProposals Boolean true Если организатор собрания позволяет приглашенным предложить новое время при ответе; в противном случае false. Необязательный параметр. Значение по умолчанию: true.
attendees Коллекция Attendee Коллекция участников события.
body ItemBody Текст сообщения, связанного с событием. В формате HTML или текстовом формате.
bodyPreview String Предварительный просмотр сообщения, связанного с событием. В текстовом формате.
cancelledOccurrences Коллекция String Содержит значения свойств occurrenceId для отмененных экземпляров в повторяющихся рядах, если событие является рядом master. Отмененные экземпляры в повторяющихся рядах называются canceledOccurences.

Возвращается только для $select в операции Get, в которой указывается идентификатор основного события в ряду (т. е. значение свойства seriesMasterId).
categories Коллекция String Категории, связанные с событием. Каждая категория соответствует свойству displayName объекта outlookCategory, определенного для пользователя.
changeKey String Указывает версию объекта события. При каждом изменении события также меняется значение ChangeKey. Благодаря этому Exchange может применять изменения к правильной версии объекта.
createdDateTime DateTimeOffset Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
end DateTimeTimeZone Дата, время и часовой пояс завершения события. По умолчанию время завершения указано в формате UTC.
exceptionOccurrences Коллекция event Содержит значения свойства id экземпляров событий, которые являются исключениями в повторяющемся ряду.
Исключения могут отличаться от других вхождений в повторяющемся ряду, таких как тема, время начала или окончания и участники. Исключения не включают отмененные вхождения.

Возвращается только для $select и $expand в операции GET, в которой указывается идентификатор основного события в ряду (т. е. значение свойства seriesMasterId).
hasAttachments Boolean Задайте значение true, если у события есть вложения.
hideAttendees Boolean Если присвоено значение true, каждый участник видит только себя в приглашении на собрание и списке собрания Отслеживание. Значение по умолчанию: false.
iCalUId String Уникальный идентификатор для события в календарях. Этот идентификатор отличается для каждого вхождения повторяющегося ряда. Только для чтения.
id String Уникальный идентификатор события. По умолчанию это значение изменяется при перемещении элемента из одного контейнера (например, папки или календаря) в другой. Чтобы изменить это поведение, используйте заголовок Prefer: IdType="ImmutableId". Дополнительные сведения см. в статье Получение неизменяемых идентификаторов для ресурсов Outlook. С учетом регистра и только для чтения.
importance String Важность события. Возможные значения: low, normal, high.
isAllDay Boolean Задайте значение true, если событие длится весь день. Если значение равно true, то независимо от того, один или несколько дней длится событие, время его начала и окончания должно быть установлено на полночь в одном и том же часовом поясе.
isCancelled Boolean Задайте значение true, если событие отменено.
isDraft Логический Задайте значение true, если пользователь обновил собрание в Outlook, но не отправил обновления участникам. Присвоено значение false, если все изменения отправлены или событие является встречей без участников.
isOnlineMeeting Логический True, если событие содержит информацию о собрании по сети (т. е. onlineMeeting указывает на ресурс onlineMeetingInfo), в противном случае — false. Значение по умолчанию — false (onlineMeeting — null). Необязательное свойство.
После настройки isOnlineMeeting на true Microsoft Graph инициализирует onlineMeeting. Outlook будет игнорировать любые последующие изменения isOnlineMeeting, и собрание останется доступным по сети.
isOrganizer Boolean Присвоено значение true, если владелец календаря (указанный свойством owner объекта calendar) является организатором события (определятся свойством organizer объекта event). Это также применимо, если делегат организовал событие от имени владельца.
isReminderOn Boolean Задайте значение true, если установлено напоминание пользователю о событии.
lastModifiedDateTime DateTimeOffset Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
location Location Место проведения события.
locations Коллекция Location Места проведения события или участия в нем. Свойства location и locations всегда совпадают друг с другом. Если вы обновите свойство location, предыдущие места в коллекции locations будут удалены и заменены новым значением location.
occurrenceId String Идентификатор вхождения в повторяющемся ряду событий. Значение NULL, если событие не является частью повторяющегося ряда.

Формат значения свойства — OID.{seriesMasterId-value}.{occurrence-start-date}. Часовым поясом для {occurrence-start-date} является свойство recurrenceTimeZone, определенное для соответствующего recurrenceRange.

Это свойство может идентифицировать любое вхождение в повторяющихся рядах, включая вхождение, которое было изменено или отменено. Это свойство можно использовать для выполнения всех операций, которые поддерживаются вхождениями в повторяющемся ряду.
onlineMeeting OnlineMeetingInfo Сведения, необходимые участнику, чтобы присоединиться к собранию по сети. Значение по умолчанию — null. Только для чтения.
После настройки свойств isOnlineMeeting и onlineMeetingProvider для разрешения собрания по сети Microsoft Graph инициализирует onlineMeeting. После завершения настройки собрание останется доступным по сети, и вы не сможете изменить свойства isOnlineMeeting, onlineMeetingProvider и onlneMeeting.
onlineMeetingProvider onlineMeetingProviderType Представляет поставщика службы собраний по сети. По умолчанию onlineMeetingProvider — unknown. Возможные значения: unknown, teamsForBusiness, skypeForBusiness и skypeForConsumer. Необязательное свойство.
После настройки onlineMeetingProvider Microsoft Graph инициализирует onlineMeeting. После этого вы не сможете изменить onlineMeetingProvider и собрание останется доступным по сети.
onlineMeetingUrl String URL-адрес для собрания по сети. Свойство будет задано только в том случае, если организатор определяет в Outlook, что событие является собранием по сети, например в Skype. Только для чтения.
Чтобы получить доступ к URL-адресу и присоединиться к собранию по сети, воспользуйтесь joinUrl, который предоставляется через свойство event, onlineMeeting. В дальнейшем использовать свойство onlineMeetingUrl не рекомендуется.
organizer Recipient Организатор события.
originalEndTimeZone String Часовой пояс завершения, указанный при создании события. Значение tzone://Microsoft/Custom указывает, что традиционный часовой пояс был задан в классическом приложении Outlook.
originalStart DateTimeOffset Представляет время начала события, когда оно изначально создается как вхождение или исключение в повторяющемся ряду. Это свойство не возвращается для событий, которые являются отдельными экземплярами. Сведения времени и даты представлены в формате ISO 8601 (всегда используется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
originalStartTimeZone String Часовой пояс начала события, указанный при его создании. Значение tzone://Microsoft/Custom указывает, что в классическом приложении Outlook задан традиционный пользовательский часовой пояс.
recurrence PatternedRecurrence Расписание повторения события.
reminderMinutesBeforeStart Int32 Позволяет указать, за сколько минут до начала события появляется напоминание.
responseRequested Логический По умолчанию используется значение true, означающее, что организатор запрашивает у приглашенного отправку ответа для события.
responseStatus ResponseStatus Указывает тип отклика, отправленного в ответ на сообщение о событии.
sensitivity String Возможные значения: normal, personal, private, confidential.
seriesMasterId String Идентификатор для элемента образца повторяющегося ряда, если это событие входит в повторяющийся ряд.
showAs String Отображаемое состояние. Возможные значения: free, tentative, busy, oof, workingElsewhere, unknown.
start DateTimeTimeZone Дата, время и часовой пояс начала события. По умолчанию время начала указано в формате UTC.
subject String Текст в строке темы сообщения о событии.
transactionId Строка Настраиваемый идентификатор, указанный клиентским приложением серверу во избежание лишних операций POST в том случае, если клиент попробует снова создать одно и то же событие. Это полезно в тех случаях, когда из-за плохого сетевого подключения клиент отключается, не успев получить от сервера ответ на предыдущий запрос клиента на создание события. После того, как при создании события вы настроили transactionId, вы можете изменить transactionId в последующем обновлении. Это свойство возвращается только в полезных данных ответа, если такая настройка была сделана в приложении. Необязательное свойство.
type String Тип события. Возможные значения: singleInstance, occurrence, exception, seriesMaster. Только для чтения
uid String Уникальный идентификатор для событий календаря. В случае повторяющихся событий для главного события серии и всех его повторений (в том числе исключений) используется одно и то же значение.
webLink String URL-адрес для открытия события в Outlook в Интернете.

Outlook в Интернете открывает это событие в браузере, если выполнен вход в почтовый ящик. В противном случае Outlook в Интернете предлагает выполнить вход.

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

Примечание.

Свойство webLink указывает URL-адрес, по которому можно открыть событие только в более ранних версиях Outlook в Интернете. Ниже представлен формат URL-адреса, где {event-id} — это зашифрованное в виде URL-адреса значение свойства id.

  • Для рабочих или учебных учетных записей: https://outlook.office365.com/owa/?itemid={event-id}&exvsurl=1&path=/calendar/item

  • Для учетных записей Майкрософт: https://outlook.live.com/owa/?itemid={event-id}&exvsurl=1&path=/calendar/item

Чтобы открыть событие в текущей версии Outlook в Интернете, преобразуйте URL-адрес в один из следующих форматов и используйте этот URL-адрес для открытия события:

  • Для рабочих или учебных учетных записей: https://outlook.office365.com/calendar/item/{event-id}

  • Для учетных записей Майкрософт: https://outlook.live.com/calendar/item/{event-id}

Связи

Связь Тип Описание
attachments Коллекция Attachment Коллекция вложений FileAttachment, ItemAttachment и referenceAttachment для события. Свойство навигации. Только для чтения. Допускается значение null.
calendar Calendar Календарь, который содержит событие. Свойство навигации. Только для чтения.
extensions Коллекция extension Коллекция открытых расширений, определенных для события. Допускается значение null.
instances Коллекция Event Вхождения в повторяющемся ряду, если событие является основным в ряду. Это свойство включает вхождения, которые являются частью шаблона повторения, и исключения, которые были изменены, но не включают вхождения, которые были отменены из ряда. Свойство навигации. Только для чтения. Допускается значение null.
multiValueExtendedProperties Коллекция multiValueLegacyExtendedProperty Коллекция расширенных свойств с несколькими значениями, определенных для события. Только для чтения. Допускается значение null.
singleValueExtendedProperties Коллекция singleValueLegacyExtendedProperty Коллекция расширенных свойств с одним значением, определенных для события. Только для чтения. Допускается значение null.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "allowNewTimeProposals": "Boolean",
  "attendees": [{"@odata.type": "microsoft.graph.attendee"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "cancelledOccurrences":["string"],
  "categories": ["string"],
  "changeKey": "string",
  "createdDateTime": "String (timestamp)",
  "end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "exceptionOccurrences":["microsoft.graph.event"],
  "hasAttachments": true,
  "hideAttendees": false,
  "iCalUId": "String",
  "id": "string (identifier)",
  "importance": "String",
  "isAllDay": true,
  "isCancelled": true,
  "isDraft": false,
  "isOnlineMeeting": true,
  "isOrganizer": true,
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "location": {"@odata.type": "microsoft.graph.location"},
  "locations": [{"@odata.type": "microsoft.graph.location"}],
  "occurrenceId":"string",
  "onlineMeeting": {"@odata.type": "microsoft.graph.onlineMeetingInfo"},
  "onlineMeetingProvider": "string",
  "onlineMeetingUrl": "string",
  "organizer": {"@odata.type": "microsoft.graph.recipient"},
  "originalEndTimeZone": "string",
  "originalStart": "String (timestamp)",
  "originalStartTimeZone": "string",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "reminderMinutesBeforeStart": 1024,
  "responseRequested": true,
  "responseStatus": {"@odata.type": "microsoft.graph.responseStatus"},
  "sensitivity": "String",
  "seriesMasterId": "string",
  "showAs": "String",
  "start": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "string",
  "type": "String",
  "uid": "String",
  "webLink": "string",

  "attachments": [ { "@odata.type": "microsoft.graph.attachment" } ],
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "extensions": [ { "@odata.type": "microsoft.graph.extension" } ],
  "instances": [ { "@odata.type": "microsoft.graph.event" }],
  "singleValueExtendedProperties": [ { "@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty" }],
  "multiValueExtendedProperties": [ { "@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty" }]
}

Связанные материалы