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`을 사용하면 제목에 해당 텍스트가 포함된(대소문자 무시) 미완료 작업 하나를 완료합니다. 여러 개가 일치하면 아무것도 완료하지 않고 일치 항목을 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에서 작업 하나를 완료로 표시합니다. Windows 전용입니다. confirm=true가 없으면 아무것도 바뀌지 않으며, 제목과 목록을 그대로 보여 주는 미리보기를 반환하지만 작업을 조회하지 않으므로 작업이 존재하는지는 알려 주지 않습니다. confirm=true를 사용하면 제목이 `subject`와 같은 작업을 찾아(부분 일치 없음, 작업 ID 없음) 100% 완료로 설정합니다. `list`가 없으면 루트 Tasks 폴더만 찾고 하위 폴더는 찾지 않습니다. `list`(todo_list_tasks의 이름 또는 전체 경로)를 지정하면 그곳만 찾으며, 알 수 없거나 여러 폴더와 일치하는 목록은 오류와 함께 거부됩니다. 해당 폴더에 제목이 같은 미완료 작업이 여러 개이면 아무것도 완료되지 않습니다. 호출은 실패하고 후보를 각각 task_id와 함께 나열하므로, 그 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"
}