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

Тип ресурса calendar

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

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

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

Методы

Метод Возвращаемый тип Описание
Список Коллекция calendar Получение всех пользовательских календарей или календарей из стандартной либо другой указанной группы календарей.
Создание calendar Создание календаря для пользователя в стандартной либо другой указанной группе календарей.
Получение calendar Получение свойств и связей объекта calendar. Календарь может быть одним для пользователя или календарем по умолчанию для группы Microsoft 365.
Обновление calendar Обновление свойств объекта calendar. Календарь может быть одним для пользователя или календарем по умолчанию для группы Microsoft 365.
Delete Нет Удаление объекта 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"}
}
  • Last updated on