TodoTask erstellen

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.

Erstellen Sie ein neues Aufgabenobjekt in einer angegebenen todoTaskList.Create a new task object in a specified todoTaskList.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

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/todo/lists/{todoTaskListId}/tasks
POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/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 todoTask-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von todoTask erforderlich sind.

Eigenschaft Typ Beschreibung
id Zeichenfolge Eindeutiger Bezeichner des Vorgangs. Standardmäßig ändert sich dieser Wert, wenn das Element von einer Liste in eine andere verschoben wird.
body itemBody Der Aufgabentext, der in der Regel Informationen zu der Aufgabe enthält.
categories Zeichenfolgenauflistung Die Kategorien, die mit der Aufgabe verknüpft sind. Jede Kategorie entspricht der displayName-Eigenschaft einer vom Benutzer definierten outlookCategory.
completedDateTime dateTimeTimeZone 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.
Wichtigkeit Wichtigkeit Die Wichtigkeit der Aufgabe. Mögliche Werte sind: low, normal und high.
isReminderOn Boolescher Wert „true“, wenn eingestellt ist, dass der Benutzer an die Aufgabe erinnert werden soll.
recurrence patternedRecurrence Das Serienmuster für die Aufgabe.
reminderDateTime dateTimeTimeZone Datum und Uhrzeit für eine Erinnerung der Aufgabe.
startDateTime dateTimeTimeZone Das Datum in der angegebenen Zeitzone, an dem der Vorgang gestartet werden soll.
status taskStatus Gibt den Status oder den Fortschritt der Aufgabe an. Mögliche Werte: notStarted, inProgress, completed, waitingOnOthers, deferred.
title String Eine kurze Beschreibung der Aufgabe.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit der Erstellung der Aufgabe. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen. Der Wert der Eigenschaft verwendet das ISO 8601-Format. Mitternacht UTC am 1. Januar 2020 würde beispielsweise wie folgt aussehen: '2020-01-01T00:00:00Z'.
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'.

Antwort

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

Beispiele

Anforderung

Im folgenden Beispiel wird ein todoTask in der angegebenen Aufgabenliste erstellt und eine linkedResource eingeschlossen.

POST https://graph.microsoft.com/beta/me/todo/lists/AQMkADAwATM0MDAAMS0yMDkyLWVjMzYtM/tasks
Content-Type: application/json

{
   "title":"A new task",
   "categories": ["Important"],
   "linkedResources":[
      {
         "webUrl":"http://microsoft.com",
         "applicationName":"Microsoft",
         "displayName":"Microsoft"
      }
   ]
}

Antwort

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

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

{
   "@odata.etag":"W/\"xzyPKP0BiUGgld+lMKXwbQAAnBoTIw==\"",
   "importance":"low",
   "isReminderOn":false,
   "status":"notStarted",
   "title":"A new task",
   "createdDateTime":"2020-08-18T09:03:05.8339192Z",
   "lastModifiedDateTime":"2020-08-18T09:03:06.0827766Z",
   "categories": ["Important"],
   "id":"AlMKXwbQAAAJws6wcAAAA=",
   "body":{
      "content":"",
      "contentType":"text"
   },
   "linkedResources":[
      {
         "id":"f9cddce2-dce2-f9cd-e2dc-cdf9e2dccdf9",
         "webUrl":"http://microsoft.com",
         "applicationName":"Microsoft",
         "displayName":"Microsoft"
      }
   ]
}