Тип ресурса calendarPermission

Статья
09/22/2023

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

Разрешения пользователя, которому предоставлен общий доступ к календарю или делегирован в клиенте Outlook.

Список, создание, получение, обновление и удаление разрешений календаря поддерживается только от имени владельца календаря.

Получение разрешений календаря от имени получателя или делегата возвращает пустую коллекцию разрешений календаря.

После настройки получателя общего ресурса или делегата для календаря можно обновить только свойство роли , чтобы изменить разрешения получателя или делегата. Невозможно обновить свойство allowedRoles, emailAddress, isInsideOrganization или isRemovable . Чтобы изменить эти свойства , удалите соответствующий объект calendarPermission и создайте другого получателя или делегата в клиенте Outlook.

Методы

Метод	Возвращаемый тип	Описание
Список	calendarPermission	Получите коллекцию объектов calendarPermission, описывающих удостоверения и роли пользователей, которым предоставлен общий или делегированный доступ к указанному календарю.
Создание	calendarPermission	Создание объекта calendarPermission.
Get calendarPermission	calendarPermission	Чтение свойств и связей объекта calendarPermission.
Обновление	calendarPermission	Обновление объекта calendarPermission.
удаление;	Нет	Удаление объекта calendarPermission.

Свойства

Свойство	Тип	Описание
allowedRoles	Коллекция calendarRoleType	Список разрешенных уровней разрешений для общего доступа или делегирования разрешений для календаря. Возможные значения: `none`, `freeBusyRead`, `limitedRead`, `read`, `write`, `delegateWithoutPrivateEventAccess`, `delegateWithPrivateEventAccess`, `custom`.
emailAddress	emailAddress	Представляет получателя общего ресурса или делегата, имеющего доступ к календарю. Для получателя общей папки "Моя организация" свойство address имеет значение NULL. Только для чтения.
id	String	Уникальный идентификатор пользователя (получателя или делегата), которому предоставлен общий доступ к календарю. Только для чтения.
isInsideOrganization	Логический	Значение true, если пользователь в контексте (получатель или делегат) находится в той же организации, что и владелец календаря.
isRemovable	Логический	`True` Значение , если пользователь может быть удален из списка получателей или делегатов указанного календаря, `false` в противном случае . Пользователь "Моя организация" определяет разрешения, которые другие пользователи в вашей организации имеют на данный календарь. Вы не можете удалить "Моя организация" в качестве получателя общего доступа в календаре.
role	calendarRoleType	Текущий уровень разрешений получателя или делегата общей папки календаря.

Значения calendarRoleType

Member	Описание
none	Календарь не предоставляется пользователю.
freeBusyRead	Пользователь — это получатель, который может просматривать состояние доступности владельца в календаре.
limitedRead	Пользователь — это получатель, который может просматривать состояние доступности, а также названия и расположения событий в календаре.
read	Пользователь — это получатель, который может просматривать все сведения о событиях в календаре, за исключением частных событий владельца.
write	Пользователь — это получатель, который может просматривать все сведения (кроме частных событий) и изменять события в календаре.
delegateWithoutPrivateEventAccess	Пользователь — это делегат, который имеет доступ на запись, но не может просматривать сведения о частных событиях владельца в календаре.
delegateWithPrivateEventAccess	Пользователь — это делегат, который имеет доступ на запись и может просматривать сведения о частных событиях владельца в календаре.
Пользовательские	Пользователь имеет настраиваемые разрешения для календаря.

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

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

{
  "allowedRoles": ["string"],
  "emailAddress": {"@odata.type": "microsoft.graph.emailAddress"},
  "id": "String (identifier)",
  "isInsideOrganization": "boolean",
  "isRemovable": "boolean",
  "role": "string"
}