BaseTask erstellen (veraltet)

  • 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.

Achtung

Der auf baseTask basierende Aufgaben-API-Satz ist ab dem 31. Mai 2022 veraltet und gibt am 31. August 2022 keine Daten mehr zurück. Verwenden Sie den auf todoTask basierenden API-Satz.

Erstellen Sie ein neues baseTask-Objekt in einer bestimmten baseTaskList.Create a new baseTask object in a specific baseTaskList.

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Tasks.ReadWrite Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Tasks.ReadWrite Nicht verfügbar.
Anwendung Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

POST /me/tasks/lists/{baseTaskListId}/tasks
POST /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks

Anforderungsheader

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

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des baseTask-Objekts an .

Sie können die folgenden Eigenschaften angeben, wenn Sie einen baseTask erstellen.

Eigenschaft Typ Beschreibung
textBody String Der Aufgabentext im Textformat, der in der Regel Informationen zur Aufgabe enthält.
createdDateTime DateTimeOffset Das Datum in der angegebenen Zeitzone, an dem die Aufgabe abgeschlossen wurde.
lastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzten Änderung der Aufgabe. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen. Der Eigenschaftswert verwendet das ISO 8601-Format, und die Angabe erfolgt immer in UTC-Zeit. Mitternacht UTC am 1. Januar 2020 würde beispielsweise wie folgt aussehen: '2020-01-01T00:00:00Z'.
bodyLastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzten Änderung der Aufgabe. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen. Der Eigenschaftswert verwendet das ISO 8601-Format, und die Angabe erfolgt immer in UTC-Zeit. Mitternacht UTC am 1. Januar 2020 würde beispielsweise wie folgt aussehen: '2020-01-01T00:00:00Z'.
completedDateTime DateTimeOffset Das Datum in der angegebenen Zeitzone, an dem die Aufgabe abgeschlossen wurde.
dueDateTime dateTimeTimeZone Das Datum in der angegebenen Zeitzone, in der die Aufgabe abgeschlossen werden soll.
startDateTime dateTimeTimeZone Das Datum in der angegebenen Zeitzone, an dem die Aufgabe begonnen werden soll.
Wichtigkeit Wichtigkeit Die Wichtigkeit der Aufgabe. Die möglichen Werte sind: low, normal, high.
recurrence patternedRecurrence Das Serienmuster für die Aufgabe.
displayName String Eine kurze Beschreibung der Aufgabe.
status taskStatus_v2 Gibt den Status oder den Fortschritt der Aufgabe an. Mögliche Werte sind: notStarted, inProgress, completed, unknownFutureValue. Erforderlich.
Sicht taskViewpoint Eigenschaften, die für einen Benutzer persönlich sind, z. B. reminderDateTime.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein baseTask-Objekt im Antworttext zurück.

Beispiele

Anforderung

POST https://graph.microsoft.com/beta/me/tasks/lists/AQMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNi/tasks
Content-Type: application/json
Content-length: 634

{
  "@odata.type": "#microsoft.graph.task",
  "textBody":  "String",
  "bodyLastModifiedDateTime": "String (timestamp)",
  "completedDateTime": "String (timestamp)",
  "dueDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "startDateTime": {
    "@odata.type": "microsoft.graph.dateTimeTimeZone"
  },
  "importance": "String",
  "recurrence": {
    "@odata.type": "microsoft.graph.patternedRecurrence"
  },
  "displayName": "String",
  "status": "String",
  "viewpoint": {
    "@odata.type": "microsoft.graph.taskViewpoint"
  }
}

Antwort

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

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.task",
    "@odata.etag": "W/\"kOO4xOT//0qFRAqk3TNe0QAABCE1Xg==\"",
    "importance": "normal",
    "status": "notStarted",
    "displayName": "Buy medicine",
    "createdDateTime": "2021-11-17T10:11:18.0229364Z",
    "lastModifiedDateTime": "2021-11-17T10:11:18.19789Z",
    "id": "AAkALgAAAAAAHYQDEapmEc2byACqAC",
    "textBody":  "",
    "parentList": {
        "id": "AQMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNi"
    }
}