Тип ресурса calendar

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

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

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

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

Методы

Метод	Возвращаемый тип	Описание
Список	Коллекция calendar	Получение всех пользовательских календарей или календарей из стандартной либо другой указанной группы календарей.
Создание	calendar	Создание календаря для пользователя в стандартной либо другой указанной группе календарей.
Получение	calendar	Получение свойств и связей объекта calendar. Календарь может быть календарем для пользователя или календарем по умолчанию для группы Microsoft 365.
Обновление	calendar	Обновление свойств объекта calendar. Календарь может быть календарем для пользователя или календарем по умолчанию для группы Microsoft 365.
Delete	Нет	Удаление объекта calendar.
Получение дельты	Коллекция 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	Логический	Указывает, можно ли удалить этот календарь из почтового ящика пользователя.
isSharedWithMe	Boolean	true Если кто-то предоставил пользователю доступ к этому календарю; false в противном случае. Для календаря владельца этому свойству всегда присвоено значение false. Это свойство задается при инициации общего доступа в клиенте Outlook и может быть сброшено при отмене общего доступа через клиента или соответствующий ресурс calendarPermission . Только для чтения.
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",
  "isSharedWithMe": "boolean",
  "isTallyingResponses": "boolean",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}
}