Verwenden der To-Do-API, die auf Basisaufgaben in Microsoft Graph basiert (veraltet)

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.

Verwenden Sie die Microsoft Graph To Do-API, um eine App zu erstellen, die eine Verbindung mit der Aufgabe der Benutzer in ihrem Postfach herstellt. Sorgen Sie für verschiedenste Erfahrungen mit Aufgaben, z. B. die folgenden:

• Erstellen Sie Aufgaben aus dem Workflow Ihrer App, z. B. aus E-Mails oder Benachrichtigungen, und speichern Sie sie in To Do. Verwenden Sie die Entität linkedResource, um die Verknüpfung in Ihre App zurückzuspeichern.
• Synchronisieren Sie die vorhandenen Aufgaben Ihrer App mit To Do, und erstellen Sie für eine bessere Priorisierung und Verwaltbarkeit eine einzige Vorgangsansicht.
• Verwalten Sie To Do-Aufgaben in einer benutzerdefinierten Geschäftsanwendung.
• Erstellen Sie checklistItems für eine Aufgabe, um komplexe Aufgaben in kleinere Schritte aufzuschlüsseln.

Zurzeit unterstützt die API nur Berechtigungen, die vom angemeldeten Benutzer delegiert wurden.

Bevor Sie mit der Nutzung der To Do-API beginnen, sehen Sie sich die Ressourcen und deren Beziehung zueinander an.

Aufgabenliste

In diesem API-Satz wird eine Aufgabenliste durch baseTaskList dargestellt, bei der es sich um einen logischen Container mit baseTask-Ressourcen handelt. Sie können Aufgaben zurzeit nur in einer Aufgabenliste erstellen. Aufgaben, die ohne Angabe einer Liste erstellt wurden, werden in der standardmäßigen Aufgabenliste erstellt. Wenn Sie alle Ihre Aufgabenlisten abrufen möchten, stellen Sie die folgende HTTP-Anforderung:

GET /me/tasks/lists

Aufgabe

In diesem API-Satz wird eine Aufgabe durch eine baseTask-Ressource dargestellt, bei der es sich um ein Arbeitselement oder ein persönliches Element handelt, das nachverfolgt und abgeschlossen werden kann. Wenn Sie Ihre Aufgaben aus einer Aufgabenliste abrufen möchten, stellen Sie die folgende HTTP-Anforderung:

GET /me/tasks/lists/{taskListId}/tasks

Prüflistenelement

Ein checklistItem-Objekt stellt ein Element dar, das dazu beiträgt, komplexe Aufgaben in wesentlich kleinere Schritte aufzuschlüsseln. Um ein checklistItem-Objekt aus einer Aufgabe abzurufen, stellen Sie die folgende HTTP-Anforderung:

GET /me/tasks/lists/{taskListId}/tasks/{taskId}/checklistItems/{checklistItems}

Verknüpfte Ressource

Ein linkedResource-Objekt stellt ein beliebiges Element aus einer Partneranwendung dar, das sich auf die Aufgabe bezieht, z. B. eine E-Mail, aus der eine Aufgabe erstellt wurde. Sie können es zum Speichern von Informationen verwenden und dann zum zugehörigen Element in Ihrer App zurückverknüpfen. Wenn Sie eine verknüpfte Ressource aus einer Aufgabe abrufen möchten, stellen Sie die folgende HTTP-Anforderung:

GET /me/tasks/lists/{taskListId}/tasks/{taskId}/linkedresources/{linkedResourceId}

Nachverfolgen von Änderungen mithilfe einer Deltaabfrage

Aus Leistungsgründen möchten Sie möglicherweise einen lokalen Cache von Objekten beibehalten und mithilfe der Deltaabfrage in regelmäßigen Abständen mit dem Server synchronisieren.

Die folgenden To Do-API-Ressourcen unterstützen die Deltaabfrage:

• baseTask-Sammlung in einer Aufgabenliste
• baseTaskList