Method: tasks.list

返回指定任务列表中的所有任务。默认情况下不会返回已分配的任务（来自 Google 文档、Chat 聊天室）。用户每个列表中最多可以有 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

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

boolean

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

boolean

指示结果中是否返回了隐藏的任务的标志。可选。默认值为 False。
updatedMin

string

要过滤的任务的上次修改时间的下限（采用 RFC 3339 时间戳）。可选。默认情况下，不会按上次修改时间过滤。
showAssigned

boolean

可选。指示结果中是否会返回分配给当前用户的任务的标志。可选。默认值为 False。

请求正文

请求正文必须为空。

响应正文

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

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

如需了解详情，请参阅授权指南。

Tasks

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

string

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

string

资源的 ETag。
nextPageToken

string

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

object (Task)

任务集合。