返回指定任务列表中的所有任务。用户每个列表最多可以有 2 万个非隐藏任务,一次最多可以有 10 万个任务。
HTTP 请求
GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
tasklist |
任务列表标识符。 |
查询参数
参数 | |
---|---|
completedMax |
要作为过滤依据的任务完成日期上限(以 RFC 3339 时间戳格式)。可选。默认设置是不按完成日期过滤。 |
completedMin |
要作为过滤依据的任务完成日期的下限(以 RFC 3339 时间戳表示)。可选。默认设置是不按完成日期过滤。 |
dueMax |
要作为过滤依据的任务截止日期上限(以 RFC 3339 时间戳格式)。可选。默认不按截止日期过滤。 |
dueMin |
要作为过滤依据的任务截止日期下限(以 RFC 3339 时间戳表示)。可选。默认不按截止日期过滤。 |
maxResults |
一个页面上返回的最大任务数。可选。默认值为 20(允许的最大值:100)。 |
pageToken |
用于指定要返回的结果页面的令牌。可选。 |
showCompleted |
此标记指示是否在结果中返回已完成的任务。可选。默认值为 True。请注意,showHidden 也必须为 True,才能显示在第一方客户端(例如网页界面和 Google 移动应用)中完成的任务。 |
showDeleted |
此标记指示是否在结果中返回已删除的任务。可选。默认值为 False。 |
updatedMin |
要作为过滤依据的任务上次修改时间的下限(以 RFC 3339 时间戳表示)。可选。默认设置为不按上次修改时间过滤。 |
请求正文
请求正文必须为空。
响应正文
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
字段 | |
---|---|
kind |
资源的类型。始终为“tasks#tasks”。 |
etag |
资源的 ETag。 |
nextPageToken |
用于访问此结果下一页的令牌。 |
items[] |
任务集合。 |
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/tasks
https://www.googleapis.com/auth/tasks.readonly
有关详情,请参阅授权指南。
任务
JSON 表示法 |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
字段 | |
---|---|
kind |
资源的类型。始终为“tasks#tasks”。 |
etag |
资源的 ETag。 |
nextPageToken |
用于访问此结果下一页的令牌。 |
items[] |
任务集合。 |