gws-keep

keep (v1)

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

gws keep <resource> <method> [flags]

API 资源

media

• download — 获取附件。通过 REST 下载附件媒体需要 alt=media 查询参数。如果请求的 MIME 类型中附件媒体不可用，则返回 400 错误请求。

notes

• create — 创建新笔记。
• delete — 删除笔记。调用者必须拥有笔记的 OWNER 角色才能删除。删除笔记会立即移除资源且无法撤销。任何协作者将失去对笔记的访问权限。
• get — 获取笔记。
• list — 列出笔记。每次列表调用返回一页结果，page_size 是返回项的上限。page_size 为零时允许服务器选择上限。ListNotesResponse 最多包含 page_size 条记录。如果还有更多项需要列出，它会提供 next_page_token 值（页面令牌是不透明值）。要获取下一页结果，将结果的 next_page_token 复制到下一个请求的 page_token 中。
• permissions — 对 'permissions' 资源的操作

发现命令

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

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

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

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