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

任务 (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 — 在指定的任务列表中创建新任务。从文档或聊天空间分配的任务无法通过任务公共 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 标志。