todo_complete_task

リマインダーと Microsoft To Do · macOS · Windows

効果: 書き込み. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

Microsoft To Do のタスクを完了済みにします。Apple リマインダー経由で動作し、Microsoft アカウントが Reminders に追加されていれば To Do と同期されるため、変更は次回の同期後に To Do に反映されます。todo_list_tasks から得た task_id を指定するのが望ましいです。代わりに `title` を指定すると、タイトルにそのテキストを含む（大文字小文字を区別しない）未完了タスクが 1 件だけの場合に、そのタスクを完了します。複数が一致した場合は 1 件も完了せず、それらを task_id 付きで一覧表示します。`list` を指定しない場合は、To Do のものだけでなくすべての Reminders リストを検索します。confirm なしで呼び出すとプレビューを返し、完了するには confirm=true を渡します。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — 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"
}

ドキュメント例

todo_complete_task のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

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

Windows

目的

Outlook デスクトップアプリ経由で、Microsoft To Do / Outlook Tasks のタスクを 1 件完了済みにします。Windows 専用です。confirm=true がない場合は何も変更されず、件名とリストを返すプレビューを返しますが、タスクの検索は行わないため、タスクが存在するかどうかは分かりません。confirm=true を付けると、件名が `subject` と等しいタスクを探し（部分一致なし、タスク ID なし）、100% 完了に設定します。`list` がない場合はルートの Tasks フォルダのみを探し、そのサブフォルダは探しません。`list`（todo_list_tasks の名前または完全なパス）を指定した場合はそこだけを探し、不明なリストや複数のフォルダに一致するリストはエラーで拒否されます。そのフォルダに同じ件名の未完了タスクが複数あるときは、どれも完了されません。呼び出しは失敗し、候補をそれぞれ task_id 付きで一覧表示します。1 件を完了するには、その task_id を指定してもう一度呼び出してください。タスクが見つからない場合は 'not found' を返し、Outlook の応答が変更を確認していない場合はエラーであり、成功とはなりません。タスクは削除されず、このサーバーには再び開くツールがありません。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — 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"
}

ドキュメント例

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