calendarPermission 资源类型

命名空间：microsoft.graph

在 Outlook 客户端中共享或委托日历的用户的权限。

仅支持代表日历所有者列出、创建、获取、更新和删除日历权限。

代表收件人或代理人获取日历的日历权限将返回空日历权限集合。

为日历设置共享收件人或代理人后，只能更新角色属性以更改收件人或代理人的权限。 无法 更新allowedRoles、 emailAddress、 isInsideOrganization 或 isRemovable 属性。 若要更改这些属性，应 删除 相应的 calendarPermission 对象，并在 Outlook 客户端中创建另一个收件人或代理人。

方法

方法	返回类型	Description
List	calendarPermission	获取 calendarPermission 对象的集合，这些对象描述已与其共享或委托指定日历的用户的标识和角色。
创建	calendarPermission	创建 calendarPermission 对象。
获取 calendarPermission	calendarPermission	读取 calendarPermission 对象的属性和关系。
更新	calendarPermission	更新 calendarPermission 对象。
删除	无	删除 calendarPermission 对象。

属性

属性	类型	说明
allowedRoles	calendarRoleType 集合	日历允许共享或委派权限级别的列表。 可取值为：none、freeBusyRead、limitedRead、read、write、delegateWithoutPrivateEventAccess、delegateWithPrivateEventAccess、custom。
emailAddress	emailAddress	表示有权访问日历的共享收件人或代理人。 对于“我的组织”共享收件人， 地址 属性为 null。 只读。
id	String	已与其共享日历的用户 (收件人或代理人) 的唯一标识符。 此为只读属性。
isInsideOrganization	布尔值	如此 如果上下文中的用户 (收件人或代理人) 与日历所有者在同一组织内。
isRemovable	Boolean	True 如果可以从指定日历的收件人或代理人列表中删除用户， false 则为 ;否则为 。 “我的组织”用户确定组织中其他人对给定日历拥有的权限。 不能将“我的组织”作为日历的共享收件人删除。
role	calendarRoleType	日历共享收件人或代理人的当前权限级别。

calendarRoleType 值

成员	说明
无	日历不与用户共享。
freeBusyRead	用户是可以在日历上查看所有者的忙/闲状态的收件人。
limitedRead	用户是可查看忙/闲状态以及日历上事件的标题和位置的收件人。
阅读	用户是可查看日历上事件的所有详细信息（所有者的私人事件除外）的收件人。
写入	用户是可查看除日历上的私人事件) 和编辑事件以外的所有详细信息 (的收件人。
delegateWithoutPrivateEventAccess	用户是具有写入权限但无法在日历上查看所有者私人事件信息的代理人。
delegateWithPrivateEventAccess	用户是具有写入权限的代理人，可以在日历上查看所有者私人事件的信息。
自 定义	用户对日历具有自定义权限。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

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