资源:任务
JSON 表示法 |
---|
{ "kind": string, "id": string, "etag": string, "title": string, "updated": string, "selfLink": string, "parent": string, "position": string, "notes": string, "status": string, "due": string, "completed": string, "deleted": boolean, "hidden": boolean, "links": [ { "type": string, "description": string, "link": string } ], "webViewLink": string } |
字段 | |
---|---|
kind |
资源的类型。始终为“tasks#task”。 |
id |
任务标识符。 |
etag |
资源的 ETag。 |
title |
任务的标题。允许的长度上限:1024 个字符。 |
updated |
任务的上次修改时间(以 RFC 3339 时间戳表示)。 |
selfLink |
指向此任务的网址。用于检索、更新或删除此任务。 |
parent |
父级任务标识符。如果是顶级任务,则省略此字段。此字段是只读字段。使用“move”方法,将任务移至其他父级下或移至顶层。 |
position |
指示任务在同一父任务下或顶层任务中的同级任务中的位置的字符串。如果此字符串大于另一个任务的对应位置字符串(根据字典顺序),则该任务将放置在同一父任务下(或位于顶层)下的另一个任务之后。此字段是只读字段。使用“move”方法将任务移动到其他位置。 |
notes |
描述任务的备注。可选。允许的长度上限:8192 个字符。 |
status |
任务的状态。其值为“needsAction”或“completed”。 |
due |
任务的截止日期(以 RFC 3339 时间戳表示)。可选。截止日期仅记录日期信息;设置截止日期时,时间戳的时间部分会被舍弃。无法通过 API 读取或写入任务的截止时间。 |
completed |
任务完成日期(以 RFC 3339 时间戳表示)。如果任务尚未完成,则省略此字段。 |
deleted |
此标记指示任务是否已删除。默认值为 False。 |
links[] |
链接集合。此集合是只读的。 |
links[].type |
链接的类型,例如“电子邮件”。 |
links[].description |
说明。采用 HTML,即 <a> 和 </a> 之间的所有内容。 |
links[].link |
网址。 |
webViewLink |
Google Tasks 网页界面中相应任务的绝对链接。此字段为只读字段。 |
方法 |
|
---|---|
|
清除指定任务列表中所有已完成的任务。 |
|
从任务列表中删除指定任务。 |
|
返回指定的任务。 |
|
对指定的任务列表创建新任务。 |
|
返回指定任务列表中的所有任务。 |
|
将指定任务移至任务列表中的其他位置。 |
|
更新指定的任务。 |
|
更新指定的任务。 |