清单功能概述

常规使用

使用创建清单接口创建一个清单。创建人自动成为清单的所有者。创建的同时，可以添加清单的初始成员。

使用获取清单详情接口可以获取到一个清单的全部数据。

使用删除清单接口可以删除一个清单。对已经删除的清单无法做任何操作。已删除的清单也无法恢复。

使用列取清单列表接口可以获取调用身份可以列取的所有清单，以分页的形式返回。

使用更新清单接口可以修改一个清单的名称和所有者。修改所有者时需要留意只有清单所有者才能修改清单的所有者。除所有者之外，更新清单接口不能增删清单的普通协作成员。

如要修改清单协作成员，需要使用添加清单成员和移除清单成员接口。

如要列取清单的所有任务，可以使用列取清单任务接口。

如果调用接口获取/编辑清单数据时得到1470403错误码（无权限访问），可以阅读本节内容来检查接口使用的access_token对应的身份是否对清单数据有读取/编辑权限。

清单有3种权限：

清单的鉴权是基于其负责人和协作成员的角色进行的。每个清单有一个且只有一个用户作为所有者（owner）。同时可以拥有多个协作成员。每个协作成员可以是可编辑（editor）或者可阅读（viewer）角色。这些角色拥有的权限如下：

协作成员可以是一个群组。当为群组时，表示该群中所有的群成员都拥有该群组的清单角色。

清单的创建人不是一个权限角色，这与任务的创建人自动获取任务编辑权限不同。清单在被创建时，清单创建用户会自动设为清单的所有者。但所有者修改为其他用户后，如果创建用户不是清单的协作成员，也不在清单的协作群组中，对该清单就无权限访问了。

综合起来，当一个用户满足如下条件时，可以读取该清单：

当一个用户满足如下条件时，可以编辑该清单（例如：修改清单名字，向清单添加任务或者调整清单中任务的顺序）：

当一个用户满足如下条件时，可以管理该清单（例如：修改清单所有者，删除清单）