Verwenden der Microsoft To Do-API

Verwenden Sie die To Do-API von Microsoft Graph zum Erstellen einer App, die eine Verbindung mit Aufgaben über Microsoft To Do-Clients 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

Eine todoTaskList stellt einen logischen Container von todoTask-Ressourcen dar. 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

Eine todoTask stellt einen Vorgang dar, d. h. eine Arbeit oder ein persönliches Element, 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