gws-tasks

tasks (v1)

先决条件： 阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则。如果缺失，请运行 gws generate-skills 创建它。

gws tasks <resource> <method> [flags]

API 资源

tasklists

• delete — 删除已认证用户的指定任务列表。如果列表包含已分配的任务，则已分配的任务和分配表面（文档、聊天空间）中的原始任务都将被删除。
• get — 返回已认证用户的指定任务列表。
• insert — 创建一个新的任务列表并将其添加到已认证用户的任务列表中。一个用户最多同时拥有 2000 个列表。
• list — 返回已认证用户的所有任务列表。一个用户最多同时拥有 2000 个列表。
• patch — 更新已认证用户的指定任务列表。此方法支持补丁语义。
• update — 更新已认证用户的指定任务列表。

tasks

• clear — 清除指定任务列表中所有已完成的任务。受影响的任务将被标记为“隐藏”，并且在默认情况下检索任务列表的所有任务时不再返回。
• delete — 从任务列表中删除指定的任务。如果任务已分配，则已分配的任务和原始任务（在文档、聊天空间中）都将被删除。要仅删除已分配的任务，请导航到分配表面并从那里取消分配任务。
• get — 返回指定的任务。
• insert — 在指定的任务列表上创建一个新任务。从文档或聊天空间分配的任务不能通过 Tasks 公共 API 插入；只能通过从文档或聊天空间分配来创建。一个用户每个列表最多拥有 20,000 个非隐藏任务，同时总共最多拥有 100,000 个任务。
• list — 返回指定任务列表中的所有任务。默认情况下不返回已分配的任务（来自文档、聊天空间）。一个用户每个列表最多拥有 20,000 个非隐藏任务，同时总共最多拥有 100,000 个任务。
• move — 将指定任务移动到目标任务列表中的另一个位置。如果未指定目标列表，则任务在其当前列表内移动。这可以包括将其作为子任务放在新的父任务下，和/或将其移动到同级任务中的不同位置。一个用户每个任务最多拥有 2,000 个子任务。
• patch — 更新指定的任务。此方法支持补丁语义。
• update — 更新指定的任务。

发现命令

在调用任何 API 方法之前，请检查它：

# 浏览资源和方法
gws tasks --help

# 检查方法的必需参数、类型和默认值
gws schema tasks.<resource>.<method>

使用 gws schema 输出来构建你的 --params 和 --json 标志。