Freigeben über

Aktualisieren von baseTask (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.

Aktualisieren sie die Eigenschaften eines baseTask-Objekts .

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

PATCH /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}
PATCH /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}

PATCH /me/tasks/alltasks/{baseTaskId}
PATCH /users/{userId|userPrincipalName}/tasks/alltasks/{baseTaskId}

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für die Eigenschaften an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

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.
bodyLastModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit der letzten Änderung des Aufgabentexts. Die Standardeinstellung ist UTC. Sie können eine benutzerdefinierte Zeitzone im Anforderungsheader bereitstellen.
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 des Ereignisses. 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.
Sicht taskViewpoint Eigenschaften, die für einen Benutzer persönlich sind, z. B. reminderDateTime.

Antwort

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

Beispiele

Anforderung

PATCH https://graph.microsoft.com/beta/me/tasks/lists/AAMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNiYQAuAAAAAAAboFsPFj7gQpLAt/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AkOO4xOT
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 200 OK
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.task",
    "@odata.etag": "W/\"kOO4xOT//0qFRAqk3TNe0QAAA1uzSQ==\"",
    "importance": "normal",
    "status": "notStarted",
    "displayName": "T-2",
    "createdDateTime": "2021-11-15T14:38:25.6868632Z",
    "lastModifiedDateTime": "2021-11-15T15:51:13.3606631Z",
    "id": "AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AkOO4xOT",
    "textBody":  "",
    "parentList": {
        "id": "AAMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNiYQAuAAAAAAAboFsPFj7gQpLAt"
    }
}