plannerPlan 资源类型plannerPlan resource type

命名空间:microsoft.graphNamespace: microsoft.graph


/betaMicrosoft Graph 中的版本下的 api 可能会发生更改。APIs under the /beta version in Microsoft Graph are subject to change. 不支持在生产应用程序中使用这些 API。Use of these APIs in production applications is not supported.

PlannerPlan资源表示 Microsoft 365 中的计划。The plannerPlan resource represents a plan in Microsoft 365. 计划可以由所有,并包含 plannerTasks 集合。A plan can be owned by a group and contains a collection of plannerTasks. 其也可以有 plannerBuckets 集合。It can also have a collection of plannerBuckets. 每个计划对象具有可以包含此计划的更多信息的 details 对象。Each plan object has a details object which can contain more information about the plan. 有关组、计划和任务之间的关系的详细信息,请参阅 PlannerFor more information about the relationships between groups, plans, and tasks, see Planner.


方法Method 返回类型Return Type 说明Description
Get plannerPlanGet plannerPlan plannerPlanplannerPlan 读取 plannerPlan 对象的属性和关系。Read properties and relationships of plannerPlan object.
List bucketsList buckets plannerBucket collectionplannerBucket collection 获取 plannerBucket 对象集合。Get a plannerBucket object collection.
List tasksList tasks plannerTask collectionplannerTask collection 获取 plannerTask 对象集合。Get a plannerTask object collection.
UpdateUpdate plannerPlanplannerPlan 更新 plannerPlan 对象。Update plannerPlan object.


属性Property 类型Type 说明Description
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset 只读。创建计划的日期和时间时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 如下所示:'2014-01-01T00:00:00Z'Read-only. Date and time at which the plan is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
idid StringString 只读。Read-only. 计划的 ID。ID of the plan. 长度为 28 个字符,区分大小写。It is 28 characters long and case-sensitive. 格式验证在服务上完成。Format validation is done on the service.
Ownerowner StringString 拥有计划的的 ID。ID of the Group that owns the plan. 必须存在有效的组才能设置此字段。A valid group must exist before this field can be set. 设置后,此属性无法更新。After it is set, this property can’t be updated.
titletitle StringString 必填。Required. 计划的标题Title of the plan.
createdBycreatedBy identitySetidentitySet 只读。Read-only. 创建计划的用户。The user who created the plan.
上下文contexts plannerPlanContextCollectionplannerPlanContextCollection 只读。Read-only. 使用此计划的其他用户体验,表示为plannerPlanContext条目。Additional user experiences in which this plan is used, represented as plannerPlanContext entries.


关系Relationship 类型Type 说明Description
bucketsbuckets plannerBucket collectionplannerBucket collection 只读。可为 Null。计划中的存储桶集合。Read-only. Nullable. Collection of buckets in the plan.
详细信息details plannerPlanDetailsplannerPlanDetails 只读。Read-only. 可为 NULL。Nullable. 关于计划的其他详细信息。Additional details about the plan.
taskstasks plannerTask collectionplannerTask collection 只读。Read-only. 可为 Null。Nullable. 计划中的任务集合。Collection of tasks in the plan.

JSON 表示形式JSON representation

下面是资源的 JSON 表示形式。Here is a JSON representation of the resource.

  "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)",
  "owner": "String",
  "title": "String"