calendarPermission 资源类型

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

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

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

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

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

方法

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

属性

属性 类型 说明
allowedRoles calendarRoleType 集合 日历允许共享或委派权限级别的列表。 可取值为:nonefreeBusyReadlimitedReadreadwritedelegateWithoutPrivateEventAccessdelegateWithPrivateEventAccesscustom
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"
}