Тип ресурса calendarPermission

Статья
09/22/2023

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

Важно!

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

Разрешения пользователя, которому предоставлен общий доступ к календарю или делегирован в клиенте 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"
}