todo_complete_task

Erinnerungen und Microsoft To Do · macOS · Windows

Wirkung: Schreiben. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Markiert eine Microsoft To Do-Aufgabe als abgeschlossen. Es arbeitet über Apple Reminders, das mit To Do synchronisiert, wenn das Microsoft-Konto zu Reminders hinzugefügt wurde, sodass die Änderung nach der nächsten Synchronisierung in To Do erscheint. Bevorzugen Sie task_id aus todo_list_tasks. Mit `title` stattdessen wird die eine offene Aufgabe abgeschlossen, deren Titel diesen Text enthält (ohne Beachtung der Groß-/Kleinschreibung); passen mehrere, wird KEINE abgeschlossen und sie werden mit ihrer task_id aufgelistet. Ohne `list` werden alle Reminders-Listen durchsucht, nicht nur die von To Do. Ohne confirm wird eine Vorschau zurückgegeben; übergeben Sie confirm=true, um abzuschließen.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to complete",
      "type": "boolean"
    },
    "list": {
      "description": "List name to narrow search by title (optional)",
      "type": "string"
    },
    "task_id": {
      "description": "Task ID from todo_list_tasks",
      "type": "string"
    },
    "title": {
      "description": "Task title (partial match, alternative to task_id)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für todo_complete_task. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "confirm": false,
  "title": "Planning meeting"
}

Windows

Zweck

Markiert eine Aufgabe in Microsoft To Do / Outlook-Aufgaben als abgeschlossen, über die Outlook-Desktop-App; nur Windows. Ohne confirm=true ändert sich nichts: Der Aufruf gibt eine Vorschau zurück, die den Betreff und die Liste wiedergibt und die Aufgabe nicht nachschlägt, sodass sie nicht aussagt, ob die Aufgabe existiert. Mit confirm=true sucht es die Aufgabe, deren Betreff `subject` entspricht (kein Teilabgleich, keine Aufgaben-ID), und setzt sie auf 100 % abgeschlossen. Ohne `list` sucht es nur im Stammordner Aufgaben, nicht in dessen Unterordnern; mit `list`, einem Namen oder vollständigen Pfad aus todo_list_tasks, sucht es nur dort, und eine unbekannte Liste oder eine, die mehreren Ordnern entspricht, wird mit einem Fehler abgelehnt. Teilen sich mehrere OFFENE Aufgaben in diesem Ordner den Betreff, wird keine abgeschlossen: Der Aufruf schlägt fehl und listet die Kandidaten auf, jeweils mit einer task_id; rufen Sie erneut mit dieser task_id auf, um eine abzuschließen. Eine fehlende Aufgabe liefert 'not found', und eine Antwort von Outlook, die die Änderung nicht bestätigt, ist ein Fehler, nie ein Erfolg. Die Aufgabe wird nicht gelöscht; dieser Server hat kein Tool, um sie wieder zu öffnen.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — Windows

{
  "properties": {
    "confirm": {
      "description": "Must be true to complete",
      "type": "boolean"
    },
    "list": {
      "description": "Task list or folder to complete the task in, by name or full path as reported by todo_list_tasks (default: only the root Tasks folder). Disambiguates when the same subject exists in more than one list. The name the cloud catalog (Mac) advertises.",
      "type": "string"
    },
    "subject": {
      "description": "Task subject (exact match)",
      "type": "string"
    },
    "task_id": {
      "description": "A task_id listed by this tool when several open tasks share the subject. Completes exactly that task; subject and list are not needed.",
      "type": "string"
    },
    "title": {
      "description": "Alias for `subject` — the name the cloud catalog (Mac) advertises. Exact match here, unlike the Mac tool's partial match.",
      "type": "string"
    }
  },
  "type": "object"
}

Dokumentationsbeispiel

{
  "confirm": false,
  "title": "Planning meeting"
}