REST Resource: tasks

资源:任务

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

string

资源的类型。始终为“tasks#task”。

id

string

任务标识符。

etag

string

资源的 ETag。

title

string

任务的标题。允许的长度上限:1024 个字符。

updated

string

任务的上次修改时间(以 RFC 3339 时间戳表示)。

parent

string

父级任务标识符。如果是顶级任务,则省略此字段。此字段是只读字段。使用“move”方法,将任务移至其他父级下或移至顶层。

position

string

指示任务在同一父任务下或顶层任务中的同级任务中的位置的字符串。如果此字符串大于另一个任务的对应位置字符串(根据字典顺序),则该任务将放置在同一父任务下(或位于顶层)下的另一个任务之后。此字段是只读字段。使用“move”方法将任务移动到其他位置。

notes

string

描述任务的备注。可选。允许的长度上限:8192 个字符。

status

string

任务的状态。其值为“needsAction”或“completed”。

due

string

任务的截止日期(以 RFC 3339 时间戳表示)。可选。截止日期仅记录日期信息;设置截止日期时,时间戳的时间部分会被舍弃。无法通过 API 读取或写入任务的截止时间。

completed

string

任务完成日期(以 RFC 3339 时间戳表示)。如果任务尚未完成,则省略此字段。

deleted

boolean

此标记指示任务是否已删除。默认值为 False。

hidden

boolean

此标记指示任务是否处于隐藏状态。如果在上次清除任务列表时任务已标记为已完成,就会出现这种情况。默认值为 False。此字段为只读字段。

links[].type

string

链接的类型,例如“电子邮件”。

links[].description

string

说明。采用 HTML,即 <a> 和 </a> 之间的所有内容。

links[].link

string

网址。

方法

clear

清除指定任务列表中所有已完成的任务。

delete

从任务列表中删除指定任务。

get

返回指定的任务。

insert

对指定的任务列表创建新任务。

list

返回指定任务列表中的所有任务。

move

将指定任务移至任务列表中的其他位置。

patch

更新指定的任务。

update

更新指定的任务。