日历资源类型

  • 项目

命名空间：microsoft.graph

重要

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

表示事件资源的容器。 它可以是 用户的日历，或者 Microsoft 365 组的默认日历。

注意：与用户日历和组日历交互的方式稍有不同：

方法

方法 返回类型 说明
列出日历 日历 集合 获取所有用户的日历，或者获取默认或其他特定日历组中的日历。
创建日历 calendar 在默认日历组或用户的指定日历组中新建日历。
Get calendar calendar 获取 calendar 对象的属性和关系。 可以是用户的日历，也可以是 Microsoft 365 组的默认日历。
更新 calendar 更新 calendar 对象的属性。 可以是用户的日历，也可以是 Microsoft 365 组的默认日历。
删除 无 删除 calendar 对象。
列出 calendarView 事件 集合 从用户的主日历 (../me/calendarView) 或指定日历中，获取由时间范围定义的日历视图中的事件发生次数、异常和单个实例。
列出事件 事件 集合 检索日历中的事件列表。 该列表包含单个实例会议和系列主控形状。
Create event event 在默认或指定日历中创建新事件。
getSchedule scheduleInformation 集合 获取用户、通讯组列表或资源在指定时间段内的忙/闲状态信息。
findMeetingTimes meetingTimeSuggestionsResult 根据组织者和与会者忙/闲状态以及时间或地点约束，建议会议时间和地点。
创建单值扩展属性 日历 在新建或现有日历中创建一个或多个单值扩展属性。
获取包含单值扩展属性的日历 日历 通过使用 $expand 或 $filter 获取包含一个单值扩展属性的日历。
创建多值扩展属性 日历 在新建或现有的日历中创建一个或多个多值扩展属性。
获取包含多值扩展属性的日历 日历 使用 $expand 获取包含一个多值扩展属性的日历。

属性

属性 类型 Description
allowedOnlineMeetingProviders OnlineMeetingProviderType 集合 表示此日历中可用于创建联机会议的联机会议服务提供商。 可取值为：unknown、skypeForBusiness、skypeForConsumer、teamsForBusiness。
calendarGroupId 字符串 要在其中创建日历的 calendarGroup。 如果用户从未显式设置日历组，则此属性为 null。
canEdit Boolean true 如果用户可以写入日历，则 false 更改。 此属性 true 日历的用户所使用。 此属性还可 true 已通过 Outlook 客户端或相应的 Permission 资源进行写入访问的用户 权限。 只读。
canShare Boolean true 如果用户有共享日历的权限，则 false 更改。 只有创建日历的用户才可以进行共享。 只读。
canViewPrivateItems Boolean true 如果用户可以阅读标记为私密的日历项目，则 false 更改。 此属性通过 Outlook 客户端或相应的 calendarPermission 资源进行设定。 只读。
changeKey String 标识 calendar 对象的版本。 每次更改日历时，changeKey 也会更改。 这样，Exchange 可以将更改应用于该对象的正确版本。 只读。
颜色 calendarColor 在 UI 中指定将该日历与其他日历区分开来的颜色主题。 属性值为： 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 Boolean 表示是否可以从用户邮箱删除此用户日志。
isShared Boolean true 如果用户已与其他用户共享日历，则 false 共享。 由于只有创建日历的用户才能共享它，因此 为共享 ， 为SharedWithMe 不能为同一 true 共享。 共享在 Outlook 客户端中发起时，此属性设定，当共享通过客户端或相应的 calendarPermission 资源取消时，可重置属性。 只读。
isSharedWithMe Boolean true 如果用户已共享此日历，则 false 共享。 此属性始终 false 所有者使用。 共享在 Outlook 客户端中发起时，此属性设定，当共享通过客户端或相应的 calendarPermission 资源取消时，可重置属性。 只读。
isTallyingResponses Boolean 表示此用户日历是否支持会议响应跟踪。 仅从用户的主日志发送的会议邀请支持会议响应跟踪。
name String 日历名称。
owner emailAddress 如果设置，则表示创建或添加日历的用户。 对于用户创建或添加的日历，将 owner 属性设置为用户。 对于与用户共享的日历，将 owner 属性设置为与此用户共享该日历的人员。 只读。

关系

关系 类型 Description
calendarPermissions calendarPermission 集合 共享日历的用户的权限。
calendarView event 集合 日历的日历视图。 导航属性。 只读。
events event 集合 日历中的事件。 导航属性。 只读。
multiValueExtendedProperties multiValueLegacyExtendedProperty 集合 为日历定义的多值扩展属性的集合。 只读。 可为 Null。
singleValueExtendedProperties singleValueLegacyExtendedProperty collection 为日历定义的单值扩展属性的集合。 只读。 可为 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",
  "isShared": "boolean",
  "isSharedWithMe": "boolean",
  "isTallyingResponses": "boolean",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.emailAddress"}
}