plannerPlan-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Die plannerPlan-Ressource stellt einen Plan in Microsoft 365 dar. Ein Plan kann im Besitz einer Gruppe sein und enthält eine Sammlung von plannerTasks. Er kann auch über eine Sammlung von plannerBuckets verfügen. Jedes plan-Objekt Plan verfügt über details-Objekt, das weitere Informationen über den Plan enthalten kann. Weitere Informationen zu den Beziehungen zwischen Gruppen, Plänen und Aufgaben finden Sie unter Planner.

Methoden

Methode	Rückgabetyp	Beschreibung
plannerPlan abrufen	plannerPlan	Dient zum Lesen der Eigenschaften und Beziehungen eines plannerPlan-Objekts.
Buckets auflisten	plannerBucket-Sammlung	Dient zum Abrufen einer plannerBucket-Objektsammlung.
Aufgaben auflisten	plannerTask-Sammlung	Dient zum Abrufen einer plannerTask-Objektsammlung.
Update	plannerPlan	Dient zum Aktualisieren eines plannerPlan-Objekts.
Löschen	Keine	PlannerPlan-Objekt löschen.

Eigenschaften

Eigenschaft	Typ	Beschreibung
Container	plannerPlanContainer	Identifiziert den Container des Plans. Nachdem sie festgelegt wurde, kann diese Eigenschaft nicht mehr aktualisiert werden. Erforderlich.
createdDateTime	DateTimeOffset	Schreibgeschützt. Datum und Uhrzeit, zu dem dieser Plan erstellt wurde. 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 ist beispielsweise 2014-01-01T00:00:00Z
id	Zeichenfolge	Schreibgeschützt. ID des Plans. Sie ist 28 Zeichen lang und es wird zwischen Groß-und Kleinschreibung unterschieden. Für den Dienst wird eine Formatüberprüfung durchgeführt.
title	String	Erforderlich. Der Titel des Plans.
createdBy	identitySet	Schreibgeschützt. Der Benutzer, der den Plan erstellt hat.
Kontexten	plannerPlanContextCollection	Schreibgeschützt. Zusätzliche Benutzeroberflächen, in denen dieser Plan verwendet wird, dargestellt als plannerPlanContext-Einträge .
Besitzer (veraltet)	Zeichenfolge	Verwenden Sie stattdessen die Eigenschaft container. ID der Gruppe, die den Plan besitzt. Nachdem sie festgelegt wurde, kann diese Eigenschaft nicht mehr aktualisiert werden. Diese Eigenschaft wird keine gültige Gruppen-ID zurückgeben, wenn der Container des Plans keine Gruppe ist.

Beziehungen

Beziehung	Typ	Beschreibung
buckets	plannerBucket-Sammlung	Sammlung von Buckets im Plan. Schreibgeschützt. Lässt NULL-Werte zu.
Details	plannerPlanDetails	Weitere Details über den Plan. Schreibgeschützt. Lässt NULL-Werte zu.
tasks	plannerTask-Sammlung	Sammlung von Aufgaben im Plan. Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "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"
}