plannerPlan-Ressourcentyp

  • Artikel

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