plannerPlan-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt einen Plan in Microsoft 365 dar. Entweder eine Gruppe oder ein Benutzer besitzt einen Plan. Pläne enthalten eine Auflistung von plannerTasks. Pläne können auch Sammlungen von plannerBuckets und plannerGoals enthalten. Jedes Planobjekt 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
Create	plannerPlan	Erstellen Sie ein plannerPlan-Objekt .
Get	plannerPlan	Dient zum Lesen der Eigenschaften und Beziehungen eines plannerPlan-Objekts.
Update	plannerPlan	Dient zum Aktualisieren eines plannerPlan-Objekts.
Löschen	Keine	Dient zum Löschen eines plannerPlan-Objekts.
Plan archivieren	plannerPlan	Archivieren eines plannerPlanPlan-Objekts.
Archivierung des Plans aufheben	plannerPlan	Heben Sie die Archivierung eines archivierten plannerPlanPlan-Objekts auf.
In Container verschieben	plannerPlan	Verschieben Sie ein plannerPlanPlan-Objekt von einem plannerPlanContainer in einen anderen.
Planbuckets auflisten	plannerBucket-Sammlung	Dient zum Abrufen einer plannerBucket-Objektsammlung.
Planziele auflisten	plannerGoal-Sammlung	Rufen Sie die mit dem Plan verknüpften Ziele ab.
Planaufgaben auflisten	plannerTask-Sammlung	Dient zum Abrufen einer plannerTask-Objektsammlung.
Delta abrufen	plannerPlan-Sammlung	Rufen Sie neu erstellte, aktualisierte oder gelöschte plannerPlanPlan-Objektein einem Gruppen - oder plannerRoster-Container ab, ohne die gesamte Ressourcensammlung vollständig lesen zu müssen.
Nutzungsrechte abrufen	planUsageRight	Rufen Sie die Nutzungsrechte für einen bestimmten Plan auf der Grundlage der zugewiesenen Vertraulichkeitsbezeichnung und der Berechtigungen des anfordernden Benutzers ab.
Verlaufselemente auflisten	plannerHistoryItem-Sammlung	Abrufen des Verlaufs der Änderungen an Aufgaben innerhalb eines Plans.

Eigenschaften

Eigenschaft	Typ	Beschreibung
archivalInfo	plannerArchivalInfo	Schreibgeschützt. Nullwerte zulassend. Enthält Informationen darüber, wer den Plan archiviert oder nicht archiviert hat und warum.
Container	plannerPlanContainer	Identifiziert den Container des Plans. Geben Sie entweder alle Eigenschaften oder nur die URL, die containerId und den Typ an. Nachdem sie festgelegt wurde, kann diese Eigenschaft nicht mehr aktualisiert werden. Sie ändert sich, wenn ein Plan mithilfe von "Plan in Container verschieben" von einem Container in einen anderen verschoben wird. Erforderlich.
contentSensitivityLabelAssignment	contentSensitivityLabelAssignment	Die Zuweisung von Vertraulichkeitsbezeichnungen für den Plan. Wird zum Klassifizieren und Schützen der Planinhalte basierend auf Organisationsrichtlinien verwendet. Diese Eigenschaft ist null , wenn keine Vertraulichkeitsbezeichnung zugewiesen ist. Optional.
Kontexte	plannerPlanContextCollection	Schreibgeschützt. Andere Benutzeroberflächen, in denen dieser Plan verwendet wird, dargestellt als plannerPlanContext-Einträge .
createdBy	identitySet	Schreibgeschützt. Der Benutzer, der den Plan erstellt hat.
createdDateTime	DateTimeOffset	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. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z
creationSource	plannerPlanCreation	Enthält Informationen über die Herkunft des Plans.
id	Zeichenfolge	Schreibgeschützt. ID des Plans. Sie ist 28 Zeichen lang und die Groß-/Kleinschreibung wird beachtet. Für den Dienst wird eine Formatüberprüfung durchgeführt.
isArchived	Boolesch	Schreibgeschützt. Wenn diese Option auf truefestgelegt ist, wird der Plan archiviert. Ein archivierter Plan ist schreibgeschützt.
title	String	Erforderlich. Der Titel des Plans.
sharedWithContainers	plannerSharedWithContainersammlung	Liste der Container, für die der Plan freigegeben ist.
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 gibt keine gültige Gruppen-ID zurück, wenn der Container des Plans keine Gruppe ist.

Beziehungen

Beziehung	Typ	Beschreibung
buckets	plannerBucket-Sammlung	Sammlung von Buckets im Plan. Schreibgeschützt. Nullwerte zulassend.
Details	plannerPlanDetails	Zusätzliche Details zum Plan. Schreibgeschützt. Nullwerte zulassend.
Ziele	plannerGoal-Sammlung	Auflistung der Ziele im Plan. Schreibgeschützt. Nullwerte zulassend.
historyItems	plannerHistoryItem-Sammlung	Sammlung von Verlaufselementen für Entitäten im Plan. Schreibgeschützt. Lässt Nullwerte zu.
tasks	plannerTask-Sammlung	Sammlung von Aufgaben im Plan. Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "archivalInfo": {"@odata.type": "microsoft.graph.plannerArchivalInfo"},
  "container": {"@odata.type": "microsoft.graph.plannerPlanContainer"},
  "contentSensitivityLabelAssignment": {"@odata.type": "microsoft.graph.contentSensitivityLabelAssignment"},
  "contexts": {"@odata.type": "microsoft.graph.plannerPlanContextCollection"},
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "creationSource": {"@odata.type": "#microsoft.graph.plannerPlanCreation"},
  "id": "String (identifier)",
  "isArchived": "Boolean",
  "owner": "String",
  "sharedWithContainers": [{"@odata.type": "microsoft.graph.plannerSharedWithContainer"}],
  "title": "String"
}