Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 Sammlung von plannerTasks. Pläne können auch eine Sammlung von plannerBuckets 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 | Archiv ein plannerPlan-Objekt. |
| Archivierung des Plans aufheben | plannerPlan | Heben Sie die Archivierung eines archivierten plannerPlan-Objekts auf. |
| In Container verschieben | plannerPlan | Verschieben sie ein plannerPlan-Objekt von einem plannerPlanContainer in ein anderes. |
| Planbuckets auflisten | plannerBucket-Sammlung | Dient zum Abrufen einer plannerBucket-Objektsammlung. |
| Planaufgaben auflisten | plannerTask-Sammlung | Dient zum Abrufen einer plannerTask-Objektsammlung. |
| Delta abrufen | plannerPlan-Sammlung | Rufen Sie neu erstellte, aktualisierte oder gelöschte plannerPlan-Objekte in einer Gruppe oder einem PlannerRoster-Typcontainer ab, ohne die gesamte Ressourcensammlung vollständig lesen zu müssen. |
| Abrufen von Nutzungsrechten | planUsageRight | Rufen Sie die Nutzungsrechte für einen bestimmten Plan basierend auf der Zuweisung der Vertraulichkeitsbezeichnung und den Berechtigungen des anfordernden Benutzers ab. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| archivalInfo | plannerArchivalInfo | Schreibgeschützt. Nullwerte zulassend. Enthält Informationen dazu, wer den Plan archiviert oder nicht archiviert hat und warum. |
| Container | plannerPlanContainer | Identifiziert den Container des Plans. Geben Sie entweder alle Eigenschaften an, oder geben Sie 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 von einem Container in einen anderen verschoben wird, wobei plan move to container verwendet wird. Erforderlich. |
| contentSensitivityLabelAssignment | contentSensitivityLabelAssignment | Die Vertraulichkeitsbezeichnungszuweisung für den Plan. Wird verwendet, um den Planinhalt basierend auf Organisationsrichtlinien zu klassifizieren und zu schützen. Diese Eigenschaft ist null , wenn keine Vertraulichkeitsbezeichnung zugewiesen ist. Optional. |
| Kontexten | plannerPlanContextCollection | Schreibgeschützt. Andere Benutzeroberflächen, in denen dieser Plan verwendet wird, werden als plannerPlanContext-Einträge dargestellt. |
| 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 zum Ursprung des Plans. |
| id | Zeichenfolge | Schreibgeschützt. ID des Plans. Es ist 28 Zeichen lang, wobei die Groß-/Kleinschreibung beachtet wird. Für den Dienst wird eine Formatüberprüfung durchgeführt. |
| isArchived | Boolesch | Schreibgeschützt. Bei Festlegung auf truewird der Plan archiviert. Ein archivierter Plan ist schreibgeschützt. |
| title | String | Erforderlich. Der Titel des Plans. |
| sharedWithContainers | plannerSharedWithContainer-Sammlung | Liste der Container, für die der Plan freigegeben wird. |
| 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. 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"
}