日历资源类型
命名空间:microsoft.graph
表示事件资源的容器。 它可以是 用户的日历,或者 Microsoft 365 组的默认日历。
注意:与用户日历和组日历交互的方式稍有不同:
- 只能将用户日历组织到 calendarGroup 中。
- Outlook 将代表组自动接受所有会议请求。 只能 接受、 暂时接受或 拒绝 用户日历的会议请求。
- Outlook 不支持对组事件提供提醒。 只能推迟或取消用户日历的提醒。
方法 | 返回类型 | 说明 |
---|---|---|
列出日历 | 日历 集合 | 获取所有用户的日历,或者获取默认或其他特定日历组中的日历。 |
创建日历 | calendar | 在默认日历组或用户的指定日历组中新建日历。 |
Get calendar | calendar | 获取 calendar 对象的属性和关系。 可以是用户的日历,也可以是 Microsoft 365 组的默认日历。 |
更新日历 | calendar | 更新 calendar 对象的属性。 可以是用户的日历,也可以是 Microsoft 365 组的默认日历。 |
删除日历 | 无 | 删除 calendar 对象。 |
列出日历视图 | 事件 集合 | 从用户的主日历 (../me/calendarview) 或指定日历中,获取由时间范围定义的日历视图中的事件发生次数、异常和单个实例。 |
列出事件 | 事件 集合 | 检索日历中的事件列表。 该列表包含单个实例会议和系列主控形状。 |
创建事件 | event | 在默认或指定日历中创建新事件。 |
获取忙/闲日程安排 | scheduleInformation 集合 | 获取用户、通讯组列表或资源在指定时间段内的忙/闲状态信息。 |
查找会议时间 | meetingTimeSuggestionsResult | 根据组织者和与会者忙/闲状态以及时间或地点约束,建议会议时间和地点。 |
创建单值属性 | 日历 | 在新建或现有日历中创建一个或多个单值扩展属性。 |
获取单值属性 | 日历 | 通过使用 $expand 或 $filter 获取包含一个单值扩展属性的日历。 |
创建多值属性 | 日历 | 在新建或现有的日历中创建一个或多个多值扩展属性。 |
获取多值属性 | 日历 | 使用 $expand 获取包含一个多值扩展属性的日历。 |
属性 | 类型 | Description |
---|---|---|
allowedOnlineMeetingProviders | OnlineMeetingProviderType 集合 | 表示此日历中可用于创建联机会议的联机会议服务提供商。 可取值为:unknown 、skypeForBusiness 、skypeForConsumer 、teamsForBusiness 。 |
canEdit | Boolean |
true 如果用户可以写入日历,则 false 更改。 此属性 true 日历的用户所使用。 此属性也 true 已共享日历并授予写入访问权限的用户使用。 |
canShare | Boolean |
true 如果用户有共享日历的权限,则 false 更改。 只有创建日历的用户才可以进行共享。 |
canViewPrivateItems | Boolean |
true 如果用户可以阅读标记为私密的日历项目,则 false 更改。 |
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 | 表示是否可以从用户邮箱删除此用户日志。 |
isTallyingResponses | Boolean | 表示此用户日历是否支持会议响应跟踪。 仅从用户的主日志发送的会议邀请支持会议响应跟踪。 |
name | String | 日历名称。 |
owner | emailAddress | 如果设置,则表示创建或添加日历的用户。 对于用户创建或添加的日历,将 owner 属性设置为用户。 对于与用户共享的日历,将 owner 属性设置为与此用户共享该日历的人员。 |
关系 | 类型 | Description |
---|---|---|
calendarPermissions | calendarPermission 集合 | 共享日历的用户的权限。 |
calendarView | Event collection | 日历的日历视图。 导航属性。 只读。 |
events | 事件 集合 | 日历中的事件。 导航属性。 只读。 |
multiValueExtendedProperties | multiValueLegacyExtendedProperty 集合 | 为日历定义的多值扩展属性的集合。 只读。 可为 Null。 |
singleValueExtendedProperties | singleValueLegacyExtendedProperty collection | 为日历定义的单值扩展属性的集合。 只读。 可为 Null。 |
以下 JSON 表示形式显示了资源类型。
{
"allowedOnlineMeetingProviders": ["string"],
"canEdit": "boolean",
"canShare": "boolean",
"canViewPrivateItems": "boolean",
"changeKey": "string",
"color": "String",
"defaultOnlineMeetingProvider": "string",
"hexColor": "String",
"id": "string (identifier)",
"isDefaultCalendar": "boolean",
"isRemovable": "boolean",
"isTallyingResponses": "boolean",
"name": "string",
"owner": {"@odata.type": "microsoft.graph.emailAddress"}
}