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.
Ein Planner V4-Plan. Ein Plan kann über den Besitzer des Containers (eine Gruppe, ein Teams-Kanal oder ein Benutzer) gefunden werden und enthält Buckets, Aufgaben, Ziele, Abhängigkeiten und andere Planner-Daten. Ein Plan ist ohne seinen besitzenden Container bedeutungslos und wird daher container standardmäßig zusammen mit id, displayName, , createdBy, createdDateTimelastModifiedBylastModifiedDateTime, , und archivalInfo/isArchivedzurückgegeben.
Erbt von plannerDelta.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | plan-Sammlung | Rufen Sie eine Liste der Planobjekte und ihrer Eigenschaften ab. |
| Create | plan | Erstellen Sie ein neues Planobjekt. |
| Get | plan | Lesen Sie die Eigenschaften und Beziehungen des Planobjekts . |
| Update | plan | Aktualisieren der Eigenschaften eines Planobjekts. |
| Löschen | Keine | Ein Planobjekt löschen. |
| Buckets auflisten | bucket-Sammlung | Rufen Sie eine Liste der Bucketobjekte und ihrer Eigenschaften ab. |
| Bucket erstellen | bucket | Erstellen Sie ein neues Bucket-Objekt. |
| Kontexte auflisten | planContextLink-Auflistung | Rufen Sie eine Liste der planContextLink-Objekte und ihrer Eigenschaften ab. |
| planContextLink erstellen | planContextLink | Erstellen Sie ein neues planContextLink-Objekt. |
| Liste customFieldDefinitions | customFieldDefinition collection | Rufen Sie eine Liste der customFieldDefinition-Objekte und ihrer Eigenschaften ab. |
| Fügen Sie customFieldDefinition hinzu | customFieldDefinition | Fügen Sie customFieldDefinitions hinzu, indem Sie in der customFieldDefinitions-Auflistung posten. |
| Entfernen von customFieldDefinitions | Keine | Entfernen Sie ein customFieldDefinition-Objekt . |
| Abhängigkeiten auflisten | Dependency Collection | Rufen Sie eine Liste der Abhängigkeitsobjekte und ihrer Eigenschaften ab. |
| App-Abhängigkeit | Abhängigkeit | Fügen Sie Abhängigkeiten hinzu, indem Sie in der Abhängigkeitensammlung posten. |
| Abhängigkeiten entfernen | Keine | Entfernen Sie ein Abhängigkeitsobjekt . |
| Ziele auflisten | Zielsammlung | Rufen Sie eine Liste der Zielobjekte und ihrer Eigenschaften ab. |
| Ziel hinzufügen | das Ziel | Fügen Sie Ziele hinzu, indem Sie in der Zielerfassung posten. |
| Ziele entfernen | Keine | Entfernen eines Zielobjekts . |
| list historyItems | historyItem-Sammlung | Rufen Sie eine Liste der historyItem-Objekte und ihrer Eigenschaften ab. |
| HistoryItem hinzufügen | historyItem | Fügen Sie historyItems hinzu, indem Sie in der historyItems-Sammlung posten. |
| Entfernen von historyItems | Keine | Entfernen Sie ein historyItem-Objekt . |
| Listenlinks | contentLink-Sammlung | Rufen Sie eine Liste der contentLink-Objekte und ihrer Eigenschaften ab. |
| ContentLink erstellen | contentLink | Erstellen Sie ein neues contentLink-Objekt. |
| Aufgaben auflisten | task-Sammlung | Rufen Sie eine Liste der Aufgabenobjekte und ihrer Eigenschaften ab. |
| Aufgabe hinzufügen | task | Hinzufügen von Aufgaben durch Posten in der Aufgabensammlung. |
| Aufgaben entfernen | Keine | Entfernen Sie ein Aufgabenobjekt . |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| archivalInfo | plannerArchivalInfo | Informationen darüber, ob und wann die Entität archiviert wurde. |
| Kalender | planCalendar | Arbeitszeitkalendereinstellungen für den Plan. |
| Fähigkeiten | planCapability | Vom Server berechnete, schreibgeschützte Funktionsflags, die angeben, welche optionalen Features für die Entität aktiviert sind. |
| Container | planContainer | Identifiziert die Gruppe, den Teams-Kanal oder den Benutzer, der den Plan besitzt. Erforderlich und nach der Erstellung unveränderlich. |
| contentSensitivityLabelAssignment | contentSensitivityLabelAssignment | Die Vertraulichkeitsbezeichnung, die Inhalten zugeordnet ist, die dem Plan zugeordnet sind. |
| creationInfo | creationInfo | Schreibgeschützte Erstellungsmetadaten für die Entität. |
| displayName | Zeichenfolge | Der Titel des Plans. |
| Dauer | Int32 | Dauer des Plans in Tagen. |
| Erweiterungen | extensionFieldCollection | Feldwerte für benutzerdefinierte Erweiterungen, die für die Entität festgelegt wurden. Unterstützt $select. |
| hasChat | Boolean | Gibt an, ob dem Plan ein Chat zugeordnet ist. |
| id | Zeichenfolge | Der eindeutige Bezeichner der Entität. Schreibgeschützt. Von Entität geerbt |
| lastModifiedBy | identitySet | Die Identität des Benutzers (oder der Anwendung), der die Entität zuletzt geändert hat. Schreibgeschützt. |
| lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung der Entität. Der Wert wird im ISO 8601-Format dargestellt und immer in UTC-Zeit angegeben. Schreibgeschützt. |
| planView | planView | Planbezogene Ansichtseinstellungen, einschließlich Kategoriedefinitionen. |
| sharedWithContainers | plannerSharedWithContainersammlung | Die Liste der Container (z. B. zusätzliche Gruppen oder Kanäle), für die der Plan freigegeben ist. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| buckets | bucket-Sammlung | Die Auflistung der Buckets im Plan. Schreibgeschützt. Nullwerte zulassend. |
| Kontexte | planContextLink-Auflistung | Die Sammlung von Kontextlinks, die beschreiben, wo der Plan angezeigt wird. Schreibgeschützt. Nullwerte zulassend. |
| customFieldDefinitions | customFieldDefinition collection | Die Auflistung der benutzerdefinierten Felddefinitionen im Plan. Schreibgeschützt. Nullwerte zulassend. |
| dependencies | Dependency Collection | Die Auflistung von Abhängigkeiten zwischen Elementen im Plan. Schreibgeschützt. Nullwerte zulassend. |
| Ziele | Zielsammlung | Die Sammlung der Ziele im Plan. Schreibgeschützt. Nullwerte zulassend. |
| historyItems | historyItem-Sammlung | Die Sammlung von Verlaufselementen (Audit) für den Plan. Schreibgeschützt. Nullwerte zulassend. |
| Links | contentLink-Sammlung | Die Sammlung von Inhaltslinks, die dem Plan zugeordnet sind. Schreibgeschützt. Lässt Nullwerte zu. |
| tasks | task-Sammlung | Die Sammlung der Aufgaben im Plan. Schreibgeschützt. Nullwerte zulassend. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.plan",
"id": "String (identifier)",
"displayName": "String",
"container": {
"@odata.type": "microsoft.graph.planContainer"
},
"calendar": {
"@odata.type": "microsoft.graph.planCalendar"
},
"creationInfo": {
"@odata.type": "microsoft.graph.creationInfo"
},
"lastModifiedBy": {
"@odata.type": "microsoft.graph.identitySet"
},
"lastModifiedDateTime": "String (timestamp)",
"archivalInfo": {
"@odata.type": "microsoft.graph.plannerArchivalInfo"
},
"planView": {
"@odata.type": "microsoft.graph.planView"
},
"contentSensitivityLabelAssignment": {
"@odata.type": "microsoft.graph.contentSensitivityLabelAssignment"
},
"hasChat": "Boolean",
"duration": "Int32",
"sharedWithContainers": [
{
"@odata.type": "microsoft.graph.plannerSharedWithContainer"
}
],
"capabilities": {
"@odata.type": "microsoft.graph.planCapability"
},
"extensions": {
"@odata.type": "microsoft.graph.extensionFieldCollection"
}
}