name: gws-tasks
description: Google Tasks：管理任务列表和任务。
metadata:
    version: 0.22.5
    openclaw:
        category: "productivity"
        requires:
            bins:
                - gws
        cliHelp: "gws tasks --help"

tasks (v1)

先决条件： 阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则。如果缺少该文件，运行 gws generate-skills 生成。

gws tasks <资源> <方法> [flags]

API 资源

tasklists

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

tasks

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

发现命令

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

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

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

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