plannerPlan 资源类型

命名空间：microsoft.graph

重要

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

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

方法

方法	返回类型	说明
Get plannerPlan	plannerPlan	读取 plannerPlan 对象的属性和关系。
List buckets	plannerBucket collection	获取 plannerBucket 对象集合。
List tasks	plannerTask collection	获取 plannerTask 对象集合。
Update	plannerPlan	更新 plannerPlan 对象。
删除	无	删除 plannerPlan 对象。
获取增量	plannerPlan 集合	在组或 plannerRoster 类型容器中获取新创建、更新或删除的 plannerPlan 对象，而无需执行整个资源集合的完整读取。
将 plannerPlan 移动到容器	plannerPlan	将 plannerPlan 对象从一个 plannerPlanContainer 移动到另一个。

属性

属性	类型	说明
容器	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 个字符，区分大小写。 格式验证在服务上完成。
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"
}