资源:任务
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 |
仅限输出。父级任务标识符。如果它是顶级任务,则省略此字段。此字段是只读字段。使用“移动”方法将任务移至其他父级或顶级。 |
position |
仅限输出。一个字符串,表示该任务在同一父级任务下或位于顶级任务的同级任务中的位置。如果此字符串大于另一任务的相应位置字符串(按字典顺序排列),则该任务将在同一父任务下(或顶级)排在另一个任务之后。使用“移动”方法将任务移至其他位置。 |
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 网页界面中相应任务的绝对链接。 |
方法 |
|
---|---|
|
清除指定任务列表中所有已完成的任务。 |
|
从任务列表中删除指定任务。 |
|
返回指定的任务。 |
|
在指定的任务列表上创建新任务。 |
|
返回指定任务列表中的所有任务。 |
|
将指定任务移至任务列表中的其他位置。 |
|
更新指定的任务。 |
|
更新指定的任务。 |