plannerPlan-RessourcentypplannerPlan resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported. Verwenden Sie die Versionsauswahl, um zu ermitteln, ob eine API in Version 1.0 verfügbar ist.To determine whether an API is available in v1.0, use the Version selector.

Die plannerPlan-Ressource stellt einen Plan in Microsoft 365 dar.The plannerPlan resource represents a plan in Microsoft 365. Ein Plan kann im Besitz einer Gruppe sein und enthält eine Sammlung von plannerTasks.A plan can be owned by a group and contains a collection of plannerTasks. Er kann auch über eine Sammlung von plannerBuckets verfügen.It can also have a collection of plannerBuckets. Jedes plan-Objekt Plan verfügt über details-Objekt, das weitere Informationen über den Plan enthalten kann.Each plan object has a details object which can contain more information about the plan. Weitere Informationen zu den Beziehungen zwischen Gruppen, Plänen und Aufgaben finden Sie unter Planner.For more information about the relationships between groups, plans, and tasks, see Planner.

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
plannerPlan abrufenGet plannerPlan plannerPlanplannerPlan Dient zum Lesen der Eigenschaften und Beziehungen eines plannerPlan-Objekts.Read properties and relationships of plannerPlan object.
Buckets auflistenList buckets plannerBucket-SammlungplannerBucket collection Dient zum Abrufen einer plannerBucket-Objektsammlung.Get a plannerBucket object collection.
Aufgaben auflistenList tasks plannerTask-SammlungplannerTask collection Dient zum Abrufen einer plannerTask-Objektsammlung.Get a plannerTask object collection.
UpdateUpdate plannerPlanplannerPlan Dient zum Aktualisieren eines plannerPlan-Objekts.Update plannerPlan object.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
Containercontainer plannerPlanContainerplannerPlanContainer Identifiziert den Container des Plans.Identifies the container of the plan. Nachdem sie festgelegt wurde, kann diese Eigenschaft nicht mehr aktualisiert werden.After it is set, this property can’t be updated. Erforderlich.Required.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Schreibgeschützt. Datum und Uhrzeit der Erstellung des Plans. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '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 ZeichenfolgeString Schreibgeschützt.Read-only. ID des Plans.ID of the plan. Sie ist 28 Zeichen lang und es wird zwischen Groß-und Kleinschreibung unterschieden.It is 28 characters long and case-sensitive. Für den Dienst wird eine Formatüberprüfung durchgeführt.Format validation is done on the service.
titletitle StringString Erforderlich. Required. Der Titel des Plans.Title of the plan.
createdBycreatedBy identitySetidentitySet Schreibgeschützt.Read-only. Der Benutzer, der den Plan erstellt hat.The user who created the plan.
contextscontexts plannerPlanContextCollectionplannerPlanContextCollection Schreibgeschützt.Read-only. Zusätzliche Benutzeroberflächen, in denen dieser Plan verwendet wird, dargestellt als plannerPlanContext-Einträge.Additional user experiences in which this plan is used, represented as plannerPlanContext entries.
owner (veraltet)owner (deprecated) ZeichenfolgeString Verwenden Sie stattdessen die Containereigenschaft.Use the container property instead. DIE ID der Gruppe, die den Plan besitzt.ID of the group that owns the plan. Nachdem sie festgelegt wurde, kann diese Eigenschaft nicht mehr aktualisiert werden.After it is set, this property can’t be updated. Diese Eigenschaft gibt keine gültige Gruppen-ID zurück, wenn der Container des Plans keine Gruppe ist.This property will not return a valid group ID if the container of the plan is not a group.

BeziehungenRelationships

BeziehungRelationship TypType BeschreibungDescription
bucketsbuckets plannerBucket-SammlungplannerBucket collection Sammlung von Buckets im Plan.Collection of buckets in the plan. Schreibgeschützt.Read-only. Nullwerte zulassend.Nullable.
Detailsdetails plannerPlanDetailsplannerPlanDetails Weitere Details über den Plan.Additional details about the plan. Schreibgeschützt.Read-only. Nullwerte zulassend.Nullable.
taskstasks plannerTask-SammlungplannerTask collection Sammlung von Aufgaben im Plan.Collection of tasks in the plan. Schreibgeschützt.Read-only. Nullwerte zulassend.Nullable.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.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)",
  "container": {
    "@odata.type": "microsoft.graph.plannerPlanContainer",
    "url": "String",
    "containerId": "String",
    "type": "String"
  },
  "title": "String"
}