Method: tasks.list

返回指定任务列表中的所有任务。用户每个列表中最多可以有 2 万项未完成任务，同时最多可以有 10 万项任务。

HTTP 请求

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

网址采用 gRPC 转码语法。

路径参数

参数
tasklist

string

任务列表标识符。

查询参数

参数
completedMax

string

要作为过滤依据的任务完成日期上限（以 RFC 3339 时间戳格式）。可选。默认设置是不按完成日期过滤。
completedMin

string

要作为过滤依据的任务完成日期的下限（以 RFC 3339 时间戳表示）。可选。默认设置是不按完成日期过滤。
dueMax

string

要作为过滤依据的任务截止日期上限（以 RFC 3339 时间戳格式）。可选。默认不按截止日期过滤。
dueMin

string

要作为过滤依据的任务截止日期下限（以 RFC 3339 时间戳表示）。可选。默认不按截止日期过滤。
maxResults

integer

一个页面上返回的最大任务数。可选。默认值为 20（允许的最大值：100）。
pageToken

string

用于指定要返回的结果页面的令牌。可选。
showCompleted

boolean

此标记指示是否在结果中返回已完成的任务。可选。默认值为 True。请注意，showHidden 也必须为 True，才能显示在第一方客户端（例如网页界面和 Google 移动应用）中完成的任务。
showDeleted

boolean

此标记指示是否在结果中返回已删除的任务。可选。默认值为 False。
showHidden

boolean

此标记指示是否在结果中返回隐藏任务。可选。默认值为 False。
updatedMin

string

要作为过滤依据的任务上次修改时间的下限（以 RFC 3339 时间戳表示）。可选。默认设置为不按上次修改时间过滤。

请求正文

请求正文必须为空。

响应正文

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
字段
kind

string

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

string

资源的 ETag。
nextPageToken

string

用于访问此结果下一页的令牌。
items[]

object (Task)

任务集合。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

有关详情，请参阅授权指南。

任务

JSON 表示法 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
字段
kind

string

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

string

资源的 ETag。
nextPageToken

string

用于访问此结果下一页的令牌。
items[]

object (Task)

任务集合。