plannerPlan 资源类型

命名空间：microsoft.graph

重要

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

plannerPlan 资源表示 Microsoft 365 中的计划。 计划可以由组所有，并包含 plannerTasks 集合。 其也可以有 plannerBuckets 集合。 每个计划对象具有可以包含此计划的更多信息的 details 对象。 有关组、计划和任务之间的关系的详细信息，请参阅 Planner。

方法

方法	返回类型	说明
Get plannerPlan	plannerPlan	读取 plannerPlan 对象的属性和关系。
List buckets	plannerBucket collection	获取 plannerBucket 对象集合。
List tasks	plannerTask collection	获取 plannerTask 对象集合。
Update	plannerPlan	更新 plannerPlan 对象。
删除	无	删除 plannerPlan 对象。

属性

属性	类型	说明
容器	plannerPlanContainer	标识计划的容器。 设置后，此属性无法更新。 必填。
createdDateTime	DateTimeOffset	只读。创建计划的日期和时间。时间戳类型表示使用 ISO 8601 格式的日期和时间信息，并且始终采用 UTC 时间。例如，UTC 时间 2014 年 1 月 1 日午夜将表示为 2014-01-01T00:00:00Z
id	String	只读。计划的 ID。长度为 28 个字符，区分大小写。格式验证在服务上完成。
title	String	必填。计划的标题
createdBy	identitySet	只读。创建计划的用户。
上下文	plannerPlanContextCollection	只读。 使用此计划的其他用户体验，表示为 plannerPlanContext 条目。
所有者（已弃用）	字符串	请改用 container 属性。 拥有计划的组的 ID。 设置后，此属性无法更新。 如果计划的容器不是组，则此属性将不会返回有效的组 ID。

关系

关系	类型	说明
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"},
  "createdDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "container": {
    "@odata.type": "microsoft.graph.plannerPlanContainer",
    "url": "String",
    "containerId": "String",
    "type": "String"
  },
  "title": "String"
}