Hinzufügen eines Plans zu einem Benutzer

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.

Fügen Sie plans_v2 hinzu, indem Sie in der plans_v2 Sammlung posten.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigung mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Nicht unterstützt Nicht unterstützt
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

POST /users/{usersId}/planner/plans_v2/$ref

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Planobjekts an.

Sie können die folgenden Eigenschaften beim Erstellen eines Plans angeben.

Eigenschaft Typ Beschreibung
displayName Zeichenfolge Der Titel des Plans. Erforderlich.
Container planContainer Identifiziert die Gruppe, den Teams-Kanal oder den Benutzer, der den Plan besitzt. Erforderlich und nach der Erstellung unveränderlich. Optional.
Kalender planCalendar Arbeitszeitkalendereinstellungen für den Plan. Optional.
archivalInfo plannerArchivalInfo Informationen darüber, ob und wann die Entität archiviert wurde. Optional.
planView planView Planbezogene Ansichtseinstellungen, einschließlich Kategoriedefinitionen. Optional.
contentSensitivityLabelAssignment contentSensitivityLabelAssignment Die Vertraulichkeitsbezeichnung, die Inhalten zugeordnet ist, die dem Plan zugeordnet sind. Optional.
hasChat Boolean Gibt an, ob dem Plan ein Chat zugeordnet ist. Optional.
Dauer Int32 Dauer des Plans in Tagen. Optional.
sharedWithContainers plannerSharedWithContainersammlung Die Liste der Container (z. B. zusätzliche Gruppen oder Kanäle), für die der Plan freigegeben ist. Optional.
Erweiterungen extensionFieldCollection Feldwerte für benutzerdefinierte Erweiterungen, die für die Entität festgelegt wurden. Unterstützt $select. Optional.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 204 No Content Antwortcode und ein Planobjekt im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/users/{usersId}/planner/plans_v2/$ref
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.plan",
  "displayName": "Product Launch Plan",
  "container": {
    "@odata.type": "microsoft.graph.planContainer"
  },
  "calendar": {
    "@odata.type": "microsoft.graph.planCalendar"
  },
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  },
  "planView": {
    "@odata.type": "microsoft.graph.planView"
  },
  "contentSensitivityLabelAssignment": {
    "@odata.type": "microsoft.graph.contentSensitivityLabelAssignment"
  },
  "hasChat": true,
  "duration": 30,
  "sharedWithContainers": [
    {
      "@odata.type": "microsoft.graph.plannerSharedWithContainer"
    }
  ],
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 204 No Content
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.plan",
  "id": "da037802-c736-af41-ff32-789862c95bd9",
  "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": "Integer",
  "sharedWithContainers": [
    {
      "@odata.type": "microsoft.graph.plannerSharedWithContainer"
    }
  ],
  "capabilities": {
    "@odata.type": "microsoft.graph.planCapability"
  },
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection"
  }
}
  • Zuletzt aktualisiert um