Verwenden der Microsoft To Do-API

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.

Verwenden Sie die auf todoTask erstellte Microsoft Graph To-Do-API, um eine App zu erstellen, die eine Verbindung mit Aufgaben über Microsoft To-Do-Clients hinweg 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.

Die API unterstützt sowohl delegierte Als auch Anwendungsberechtigungen.

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 todoTaskList dargestellt, bei der es sich um einen logischen Container mit todoTask-Ressourcen handelt. Sie können Aufgaben zurzeit nur in einer Aufgabenliste erstellen. Wenn Sie alle Ihre Aufgabenlisten abrufen möchten, stellen Sie die folgende HTTP-Anforderung:

GET /me/todo/lists

Aufgabe

In diesem API-Satz wird eine Aufgabe durch eine todoTask-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/todo/lists/{todoTaskListId}/tasks

Prüflistenelement

Ein checklistItem-Objekt stellt eine Teilaufgabe in einem größeren todoTask-Objekt dar. Das ChecklistItem-Objekt ermöglicht das Aufteilen einer komplexen Aufgabe in umsetzbarere, kleinere Aufgaben. Um ein checklistItem-Objekt aus einer Aufgabe abzurufen, stellen Sie die folgende HTTP-Anforderung:

GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/checklistItems/{checklistItems}

Verknüpfte Ressource

Eine linkedResource stellt ein beliebiges Element aus einer Partneranwendung dar, das sich auf die Aufgabe bezieht, z. B. ein Element wie 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/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/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:

• todoTask-Sammlung in einer Aufgabenliste
• todoTaskList