计划资源类型

命名空间: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"
  }
}