Freigeben über


Microsoft To-Do (Verbraucher)

Microsoft To-Do ist eine intelligente Aufgabenverwaltungs-App, mit der Sie Ihren Tag ganz einfach planen und verwalten können. Stellen Sie eine Verbindung mit Microsoft To-Do her, um Ihre Aufgaben über verschiedene Dienste zu verwalten. Sie können Aktionen wie das Erstellen von Aufgaben ausführen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Norm Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Norm Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Microsoft
URL Microsoft LogicApps-Unterstützung
Microsoft Power Automate-Support
Microsoft Power Apps-Unterstützung
Connectormetadaten
Herausgeber Microsoft
Webseite https://todo.microsoft.com/tasks/

Bekannte Probleme und Einschränkungen

Die Aufgaben-API verfügt über die meisten Outlook-Aufgabenfunktionen . Bitte beachten Sie, dass outlookTaskGroup-Entität, erweiterte Eigenschaften und assignedTo, Besitzereigenschaften der outlookTask-Entität in der To Do-API nicht verfügbar sind.

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden
Häufigkeit der Triggerumfragen 1 120 Sekunden

Aktionen

Abrufen einer to-do

Dieser Vorgang wird verwendet, um die to-do mit der angegebenen ID abzurufen.

Abrufen einer to-do Liste

Dieser Vorgang wird verwendet, um eine bestimmte to-do Liste abzurufen.

Aktualisieren einer to-do-Liste

Dieser Vorgang wird verwendet, um eine bestimmte to-do Liste zu aktualisieren.

Aktualisieren von to-do

Dieser Vorgang wird verwendet, um eine bestimmte to-dozu aktualisieren.

Alle to-do Listen auflisten

Gibt eine Liste aller to-do Listen zurück.

Auflisten to-do's nach Ordner

Dieser Vorgang wird verwendet, um alle to-doaus einer bestimmten Liste abzurufen.

Erstellen einer to-do Liste

Dieser Vorgang wird verwendet, um eine neue to-do Liste zu erstellen.

Hinzufügen eines to-do

Dieser Vorgang wird verwendet, um eine to-do in der angegebenen to-do Liste zu erstellen.

Löschen einer to-do Liste

Dieser Vorgang wird verwendet, um eine bestimmte to-do Liste zu löschen.

to-do löschen

Dieser Vorgang wird zum Löschen einer Aufgabe verwendet.

Abrufen einer to-do

Dieser Vorgang wird verwendet, um die to-do mit der angegebenen ID abzurufen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aufgabenliste
folderId True string

Aufgabenliste

To-Do-Aufgabe
id True string

To-Do-Aufgabe

Gibt zurück

Ein Microsoft To-Do-Objekt.

Body
ToDo

Abrufen einer to-do Liste

Dieser Vorgang wird verwendet, um eine bestimmte to-do Liste abzurufen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aufgabenliste
folderId True string

Aufgabenliste

Gibt zurück

Eine Microsoft To-Do-Liste.

Body
TodoList

Aktualisieren einer to-do-Liste

Dieser Vorgang wird verwendet, um eine bestimmte to-do Liste zu aktualisieren.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aufgabenliste
folderId True string

Aufgabenliste

Name
displayName True string

Listenname

Gibt zurück

Eine Microsoft To-Do-Liste.

Body
TodoList

Aktualisieren von to-do

Dieser Vorgang wird verwendet, um eine bestimmte to-dozu aktualisieren.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aufgabenliste
folderId True string

Aufgabenliste

To-Do-Aufgabe
id True string

To-Do-Aufgabe

Fälligkeitsdatum
dateTime date-time

JJJJ-MM-TTThh:mm:ss

Erinnerungs-Date-Time
dateTime date-time

JJJJ-MM-TTThh:mm:ss

Wichtigkeit
importance string

Niedrig, normal oder hoch.

Title
title string

Kurze Beschreibung oder Titel der to-do.

Der Status
status string

Gibt den Status oder den Fortschritt des to-do an – nicht gestartet, in Bearbeitung, abgeschlossen, auf andere oder verzögert.

Content
content html

Der Inhalt des Elements.

Ist Erinnerung an
isReminderOn boolean

True, wenn eine Warnung so festgelegt ist, dass der Benutzer an die to-doerinnert.

Gibt zurück

Ein Microsoft To-Do-Objekt.

Body
ToDo

Alle to-do Listen auflisten

Gibt eine Liste aller to-do Listen zurück.

Gibt zurück

Auflisten to-do's nach Ordner

Dieser Vorgang wird verwendet, um alle to-doaus einer bestimmten Liste abzurufen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aufgabenliste
folderId True string

Aufgabenliste

Höchste Anzahl
$top integer

Gesamtzahl der abzurufenden Einträge (Standard = 10, maximum = 999).

Gibt zurück

response
array of ToDo

Erstellen einer to-do Liste

Dieser Vorgang wird verwendet, um eine neue to-do Liste zu erstellen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Name
displayName True string

Listenname

Gibt zurück

Eine Microsoft To-Do-Liste.

Body
TodoList

Hinzufügen eines to-do

Dieser Vorgang wird verwendet, um eine to-do in der angegebenen to-do Liste zu erstellen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aufgabenliste
folderId True string

Aufgabenliste

Fälligkeitsdatum
dateTime date-time

JJJJ-MM-TTThh:mm:ss

Erinnerungs-Date-Time
dateTime date-time

JJJJ-MM-TTThh:mm:ss

Wichtigkeit
importance string

Niedrig, normal oder hoch.

Title
title True string

Kurze Beschreibung oder Titel der to-do.

Der Status
status string

Gibt den Status oder den Fortschritt des to-do an – nicht gestartet, in Bearbeitung, abgeschlossen, auf andere oder verzögert.

Content
content html

Der Inhalt des Elements.

Ist Erinnerung an
isReminderOn boolean

True, wenn eine Warnung so festgelegt ist, dass der Benutzer an die to-doerinnert.

Gibt zurück

Ein Microsoft To-Do-Objekt.

Body
ToDo

Löschen einer to-do Liste

Dieser Vorgang wird verwendet, um eine bestimmte to-do Liste zu löschen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aufgabenliste
folderId True string

Aufgabenliste

to-do löschen

Dieser Vorgang wird zum Löschen einer Aufgabe verwendet.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aufgabenliste
folderId True string

Aufgabenliste

To-Do-Aufgabe
id True string

To-Do-Aufgabe

Auslöser

Wenn ein neuer to-do in einem bestimmten Ordner erstellt wird

Wird ausgelöst, wenn eine neue to-do in einem bestimmten Ordner erstellt wird.

Wenn ein to-do in einem bestimmten Ordner aktualisiert wird

Wird ausgelöst, wenn ein to-do in einem bestimmten Ordner aktualisiert wird.

Wenn ein neuer to-do in einem bestimmten Ordner erstellt wird

Wird ausgelöst, wenn eine neue to-do in einem bestimmten Ordner erstellt wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aufgabenliste
folderId True string

Aufgabenliste

Gibt zurück

Ein Microsoft To-Do-Objekt.

Body
ToDo

Wenn ein to-do in einem bestimmten Ordner aktualisiert wird

Wird ausgelöst, wenn ein to-do in einem bestimmten Ordner aktualisiert wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Aufgabenliste
folderId True string

Aufgabenliste

Gibt zurück

Ein Microsoft To-Do-Objekt.

Body
ToDo

Definitionen

TodoList

Eine Microsoft To-Do-Liste.

Name Pfad Typ Beschreibung
Id
id string

Eindeutiger Bezeichner der liste to-do.

Name
displayName string

Name der liste to-do.

Bekannter Name
wellknownListName string

Eigenschaft, die den bekannten Listennamen angibt, wenn die angegebene Liste eine bekannte Liste ist. Mögliche Werte sind: none, defaultList, flaggedEmails, unknownFutureValue.

Ist Besitzer
isOwner boolean

True, wenn der Benutzer Besitzer der angegebenen Aufgabenliste ist.

Ist freigegeben
isShared boolean

True, wenn die Aufgabenliste für andere Benutzer freigegeben wird.

ToDo

Ein Microsoft To-Do-Objekt.

Name Pfad Typ Beschreibung
Id
id string

Eindeutiger Bezeichner des to-do.

Erstellt Date-Time
createdDateTime date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format)

Geänderte Date-Time
lastModifiedDateTime date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format)

Inhaltstyp
body.contentType string

Der Typ des Inhalts. Mögliche Werte sind Text und HTML.

Content
body.content string

Der Inhalt des Elements.

Geänderte Date-Time
bodyLastModifiedDateTime date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format)

Datum
completedDateTime.dateTime date-time

JJJJ-MM-TTThh:mm:ss

Datum
dueDateTime.dateTime date-time

JJJJ-MM-TTThh:mm:ss

Wichtigkeit
importance string

Niedrig, normal oder hoch.

Ist Erinnerung an
isReminderOn boolean

True, wenn eine Warnung so festgelegt ist, dass der Benutzer an die to-doerinnert.

Datum/Zeit
reminderDateTime.dateTime date-time

JJJJ-MM-TTThh:mm:ss

Der Status
status string

Gibt den Status oder den Fortschritt des to-do an – nicht gestartet, in Bearbeitung, abgeschlossen, auf andere oder verzögert.

Title
title string

Kurze Beschreibung oder Titel der to-do.