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 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.
Archivplan	plannerPlan	Archivieren sie ein plannerPlan-Objekt .
Aufheben der Archivierung des Plans	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.

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.
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
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.
creationSource	plannerPlanCreation	Enthält Informationen zum Ursprung des Plans.
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.
sharedWithContainers	plannerSharedWithContainer-Sammlung	Liste der Container, für die der Plan freigegeben wird.

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 zeigt den Ressourcentyp.

{
  "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"},
  "creationSource": {"@odata.type": "#microsoft.graph.plannerPlanCreation"},
  "createdDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "container": {
    "@odata.type": "microsoft.graph.plannerPlanContainer",
    "url": "String",
    "containerId": "String",
    "type": "String"
  },
  "sharedWithContainers": [
    {
      "@odata.type": "microsoft.graph.plannerSharedWithContainer"
    }
  ],
  "title": "String"
}