命名空间:microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
表示 Planner 统一计划图形 API 中的计划。 计划属于 容器 ,包含 存储桶、 任务和相关的计划数据。 创建元数据通过 creationInfo 公开,而不是顶级 createdBy 和 createdDateTime 属性。
使用列出的方法创建、读取、更新和删除计划。 关系的存在并不意味着其相关对象支持独立的创建、更新或删除操作。 有关支持的嵌套创建,请参阅 创建计划。
继承自 plannerDelta。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | 计划集合 | 获取计划对象及其属性的列表。 |
| 创建 | plan | 创建新的计划对象。 |
| Get | plan | 读取 计划 对象的属性和关系。 |
| 更新 | plan | 更新计划对象的属性。 |
| 删除 | 无 | 删除计划对象。 |
| List buckets | 存储桶集合 | 获取存储桶对象及其属性的列表。 |
| 创建存储桶 | bucket | 创建新的存储桶对象。 |
| 列表上下文 | planContextLink 集合 | 获取 planContextLink 对象及其属性的列表。 |
| 列出 customFieldDefinitions | customFieldDefinition 集合 | 获取 customFieldDefinition 对象及其属性的列表。 |
| 列出依赖项 | 依赖项 集合 | 获取依赖对象及其属性的列表。 |
| 列出目标 | 目标 收集 | 获取目标对象及其属性的列表。 |
| 列出 historyItems | historyItem 集合 | 获取 historyItem 对象及其属性的列表。 |
| 列表链接 | contentLink 集合 | 获取 contentLink 对象及其属性的列表。 |
| List tasks | 任务集合 | 获取任务对象及其属性的列表。 |
| 创建任务 | task | 通过根任务集合创建任务,在请求正文中有此计划的 ID。 |
| 删除任务 | 无 | 通过根任务 URL 删除任务。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| archivalInfo | plannerArchivalInfo | 有关实体是否存档以及何时存档的服务填充信息。 只读。 |
| 日历 | planCalendar | 计划的工作时间日历设置。 |
| capabilities | planCapability | 服务器计算的只读功能标志,指示为实体启用了哪些可选功能。 |
| 容器 | planContainer | 标识拥有计划的组、Teams 频道或用户。 创建后必需且不可变。 |
| contentSensitivityLabelAssignment | contentSensitivityLabelAssignment | 分配给与计划关联的内容的敏感度标签。 |
| creationInfo | creationInfo | 实体的只读创建元数据。 |
| displayName | String | 计划的标题。 |
| duration | Int32 | 计算的计划持续时间(以秒为单位)。 只读。 |
| extensions | extensionFieldCollection | 在实体上设置的自定义扩展字段值。 支持$select。 |
| hasChat | 布尔值 | 指示计划是否有关联的聊天。 只读。 |
| id | String | 实体的唯一标识符。 只读。 继承自 实体 |
| lastModifiedBy | identitySet | 上次修改实体的用户 (或应用程序) 的标识。 只读。 |
| lastModifiedDateTime | DateTimeOffset | 上次修改实体的日期和时间。 该值以 ISO 8601 格式表示,并且始终采用 UTC 时间。 只读。 |
| planView | planView | 计划范围内的视图设置,包括类别定义。 |
| sharedWithContainers | plannerSharedWithContainer 集合 | 容器列表 (例如,与计划共享的其他组或频道) 。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| buckets | 存储桶集合 | 计划中的存储桶集合。 只读。 可为 NULL。 |
| 上下文 | planContextLink 集合 | 描述平面图显示位置的上下文链接。 可在使用深插入创建计划时提供。 可为 Null。 |
| customFieldDefinitions | customFieldDefinition 集合 | 计划中自定义域定义的集合。 只读。 可为 Null。 |
| dependencies | 依赖项 集合 | 计划中项之间的依赖项的集合。 只读。 可为 Null。 |
| 目标 | 目标 收集 | 计划中的目标集合。 只读。 可为 NULL。 |
| historyItems | historyItem 集合 | 历史记录 (审核计划) 项的集合。 只读。 可为 NULL。 |
| links | contentLink 集合 | 附加到计划的内容链接。 可在使用深插入创建计划时提供。 可为 Null。 |
| 任务 | 任务集合 | 计划中的任务集合。 只读。 可为 Null。 |
JSON 表示形式
以下 JSON 表示形式显示资源类型。
{
"@odata.type": "#microsoft.graph.plan",
"id": "String (identifier)",
"displayName": "String",
"container": {
"@odata.type": "microsoft.graph.planContainer"
},
"calendar": {
"@odata.type": "microsoft.graph.planCalendar"
},
"creationInfo": {
"@odata.type": "microsoft.graph.creationInfo"
},
"lastModifiedBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"lastModifiedDateTime": "String (timestamp)",
"archivalInfo": {
"@odata.type": "microsoft.graph.plannerArchivalInfo"
},
"planView": {
"@odata.type": "microsoft.graph.planView"
},
"contentSensitivityLabelAssignment": {
"@odata.type": "microsoft.graph.contentSensitivityLabelAssignment"
},
"hasChat": "Boolean",
"duration": "Int32",
"sharedWithContainers": [
{
"@odata.type": "microsoft.graph.plannerSharedWithContainer"
}
],
"capabilities": {
"@odata.type": "microsoft.graph.planCapability"
},
"extensions": {
"@odata.type": "microsoft.graph.extensionFieldCollection"
}
}