plannerPlan 资源类型

项目
07/03/2024

命名空间：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	标识计划的容器。指定所有属性，或仅指定 url、 containerId 和类型。设置后，无法更新此属性。当计划从一个容器移动到另一个容器（使用计划移动到容器）时，它会更改。必填。
上下文	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"
}

通过

plannerPlan 资源类型

方法

属性

关系

JSON 表示形式

反馈

其他资源