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)

任务集合。