Тип ресурса calendar

  • Статья

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

Представляет контейнер для ресурсов event. Это может быть календарь для пользователя или стандартный календарь для группы Microsoft 365.

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

Методы

Метод Возвращаемый тип Описание
Список календарей Коллекция calendar Получение всех пользовательских календарей или календарей из стандартной либо другой указанной группы календарей.
Создание календаря calendar Создание календаря для пользователя в стандартной либо другой указанной группе календарей.
Получение календаря calendar Получение свойств и связей объекта calendar. Это может быть календарь для пользователя или стандартный календарь для группы Microsoft 365.
Обновление календаря calendar Обновление свойств объекта calendar. Это может быть календарь для пользователя или стандартный календарь для группы Microsoft 365.
Удаление календаря Нет Удаление объекта calendar.
Список представлений календаря Коллекция event Получение в представлении календаря повторений, исключений и отдельных экземпляров событий за определенный диапазон времени, указанных в основном календаре пользователя (../me/calendarview) или в другом заданном календаре.
Список событий Коллекция event Получение списка событий в календаре. В этом списке указаны единичные собрания и главные собрания в соответствующих сериях.
Создание события event Создание события в стандартном или указанном календаре.
Получение сведений о доступности Коллекция scheduleInformation Получение сведений о доступности коллекции пользователей, списков рассылки или ресурсов для определенного периода времени.
Поиск времени для собрания meetingTimeSuggestionsResult Предложение времени проведения собрания и местоположения с учетом доступности организатора и участников, а также ограничений по местоположению или времени.
Создание однозначного свойства calendar Создание одного или нескольких расширенных свойств с одним значением в новом или существующем календаре.
Получение однозначного свойства calendar Получение календарей, которые содержат расширенное свойство с одним значением, при помощи $expand или $filter.
Создание свойства с несколькими значениями calendar Создание одного или нескольких расширенных свойств с несколькими значениями в новом или существующем календаре.
Получение свойства с несколькими значениями calendar Получение календаря, который содержит расширенное свойство с несколькими значениями, при помощи $expand.

Свойства

Свойство Тип Описание
allowedOnlineMeetingProviders Коллекция onlineMeetingProviderType Представляет поставщиков служб собраний по сети, которых можно использовать для создания собраний в этом календаре. Возможные значения: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
canEdit Boolean Значение true, если пользователь может вносить изменения в календарь, в противном случае — значение false. Это свойство имеет значение true для пользователя, создавшего календарь. Это свойство также имеет значение true для пользователей, которые совместно используют календарь и имеют доступ на запись.
canShare Boolean Значение true, если у пользователя есть разрешение на совместное использование календаря, в противном случае — значение false. Только пользователь, создавший календарь, может предоставлять общий доступ к нему.
canViewPrivateItems Boolean Значение true, если пользователь может читать элементы календаря, которые были помечены как частные, в противном случае — значение false.
changeKey String Указывает версию объекта calendar. При каждом изменении календаря изменяется и changeKey. Благодаря этому Exchange может применять изменения к правильной версии объекта. Только для чтения.
color calendarColor Задает цветовую тему, отличающую этот календарь от других календарей в пользовательском интерфейсе. Возможные значения: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColor.
defaultOnlineMeetingProvider onlineMeetingProviderType Стандартный поставщик для собраний по сети, отправленных из этого календаря. Возможные значения: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
hexColor String Цвет календаря, представленный кодом из трех шестнадцатеричных значений в диапазоне от 00 до FF, которые обозначают красный, зеленый и синий компоненты цвета в цветовом пространстве RGB. Если пользователь не задал цвет календаря явным образом, это свойство будет пустым. Только для чтения.
id String Уникальный идентификатор календаря. Только для чтения.
isDefaultCalendar Boolean Значение true, если это стандартный календарь, где новые события создаются по умолчанию. В противном случае — значение false.
isRemovable Логический Указывает, можно ли удалить этот календарь из почтового ящика пользователя.
isTallyingResponses Логический Указывает, поддерживает ли этот пользовательский календарь отслеживание ответов на приглашения на собрания. Только приглашения на собрания, отправленные из основных календарей пользователей, поддерживают отслеживание ответов на приглашения на собрания.
name String Имя календаря.
owner emailAddress Если это свойство задано, оно указывает на пользователя, создавшего или добавившего календарь. В календаре, созданном или добавленном пользователем, свойство owner установлено для этого пользователя. В календаре, который используется совместно с пользователем, свойство owner установлено для лица, предоставившего пользователю общий доступ к этому календарю.

Связи

Связь Тип Описание
calendarPermissions Коллекция calendarPermission Разрешения пользователей, которым предоставлен доступ к календарю.
calendarView Коллекция Event Представление календаря для календаря. Свойство навигации. Только для чтения.
events Коллекция Event События в календаре. Свойство навигации. Только для чтения.
multiValueExtendedProperties Коллекция multiValueLegacyExtendedProperty Коллекция расширенных свойств с несколькими значениями, определенных для календаря. Только для чтения. Допускается значение null.
singleValueExtendedProperties Коллекция singleValueLegacyExtendedProperty Коллекция расширенных свойств с одним значением, определенных для календаря. Только для чтения. Допускается значение null.

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

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

{
  "allowedOnlineMeetingProviders": ["string"],
  "canEdit": "boolean",
  "canShare": "boolean",
  "canViewPrivateItems": "boolean",
  "changeKey": "string",
  "color": "String",
  "defaultOnlineMeetingProvider": "string",
  "hexColor": "String",
  "id": "string (identifier)",
  "isDefaultCalendar": "boolean",
  "isRemovable": "boolean",
  "isTallyingResponses": "boolean",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}
}