plannerPlan 资源类型

命名空间:microsoft.graph

重要

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

表示 Microsoft 365 中的计划。 用户拥有计划。 计划包含 plannerTasks 的集合。 计划还可以包含 plannerBuckets 的集合。 每个计划对象具有可以包含此计划的更多信息的详细信息对象。 有关组、计划和任务之间的关系的详细信息,请参阅 Planner

方法

方法 返回类型 说明
创建 plannerPlan 创建 plannerPlan 对象。
Get plannerPlan 读取 plannerPlan 对象的属性和关系。
Update plannerPlan 更新 plannerPlan 对象。
删除 删除 plannerPlan 对象。
存档计划 plannerPlan 存档 plannerPlan 对象。
非存档计划 plannerPlan 取消存档的 plannerPlan 对象。
移动到容器 plannerPlan plannerPlan 对象从一个 plannerPlanContainer 移动到另一个。
列出计划存储桶 plannerBucket collection 获取 plannerBucket 对象集合。
列出计划任务 plannerTask collection 获取 plannerTask 对象集合。
获取增量 plannerPlan 集合 plannerRoster 类型容器中获取新创建、更新或删除的 plannerPlan 对象,而无需执行整个资源集合的完整读取。

属性

属性 类型 说明
archivalInfo plannerArchivalInfo 此为只读属性。 可为 NULL。 包含有关谁存档或取消存档计划以及原因的信息。
容器 plannerPlanContainer 标识计划的容器。 指定所有属性,或仅指定 urlcontainerId类型。 设置后,无法更新此属性。 当计划从一个容器移动到另一个容器(使用 计划移动到容器)时,它会更改。 必填。
上下文 plannerPlanContextCollection 此为只读属性。 使用此计划的其他用户体验,表示为 plannerPlanContext 条目。
createdBy identitySet 只读。 创建计划的用户。
createdDateTime DateTimeOffset 只读。 创建计划的日期和时间 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
id String 只读。 计划的 ID。 长度为 28 个字符,区分大小写。 格式验证在服务上完成。
isArchived Boolean 此为只读属性。 如果设置为 true,则会存档计划。 存档的计划是只读的。
title String 必填。 计划的标题
creationSource plannerPlanCreation 包含有关计划源的信息。
所有者(已弃用) 字符串 请改用container属性。 拥有计划的的 ID。 设置后,无法更新此属性。 如果计划的容器不是组,则此属性不会返回有效的组 ID。
sharedWithContainers plannerSharedWithContainer 集合 与之共享计划的容器列表。

关系

关系 类型 说明
buckets plannerBucket collection 计划中的存储桶集合。 此为只读属性。 可为 NULL。
详细信息 plannerPlanDetails 有关该计划的其他详细信息。 此为只读属性。 可为 Null。
tasks plannerTask collection 计划中的任务集合。 此为只读属性。 可为 Null。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "contexts": {
    "48#19%3Ad128c63941b24733951ea7defd81e550%40thread%2Eskype19%3Ad128c63941b24733951ea7defd81e550%40thread%2Eskype": {
        "@odata.type": "#microsoft.graph.plannerPlanContext",
        "associationType": "Board",
        "createdDateTime": "2015-10-14T00:57:28.4698344Z",
        "displayNameSegments": [
            "Finance Team",
            "Budget Plans"
        ],
        "ownerAppId": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346"
    }
  },
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "creationSource": {"@odata.type": "#microsoft.graph.plannerPlanCreation"},
  "createdDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "container": {
    "@odata.type": "microsoft.graph.plannerPlanContainer",
    "url": "String",
    "containerId": "String",
    "type": "String"
  },
  "sharedWithContainers": [
    {
      "@odata.type": "microsoft.graph.plannerSharedWithContainer"
    }
  ],
  "title": "String"
}