使用任务参数
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
除了可与大多数 Google API 一起使用的标准查询参数外,还有一组 Tasks 参数。
下表总结了仅适用于 Google Tasks API 中的请求参数。所有参数值都需要经过网址编码。
参数 |
含义 |
备注 |
适用性 |
completedMax |
任务完成日期的上限(采用 RFC 3339 时间戳形式),以进行过滤。 |
- 默认:
completedMax=2031-01-01
- 使用 RFC 3339 时间戳格式。例如:
2010-08-09T10:57:00.000-08:00 。
|
|
completedMin |
任务完成日期的下限(以 RFC 3339 时间戳形式过滤)。 |
- 默认:
completedMin=1970-01-01
- 使用 RFC 3339 时间戳格式。例如:
2010-08-09T10:57:00.000-08:00 。
|
|
dueMax |
任务截止日期(以 RFC 3339 时间戳形式)进行过滤的上限。 |
- 默认:
dueMax=2031-01-01
- 使用 RFC 3339 时间戳格式。例如:
2010-08-09T10:57:00.000-08:00 。
|
|
dueMin |
任务的截止日期(以 RFC 3339 时间戳为准),以进行过滤。 |
- 默认:
dueMin=1970-01-01
- 使用 RFC 3339 时间戳格式。例如:
2010-08-09T10:57:00.000-08:00 。
|
|
maxResults |
随该请求返回的元素数上限。 |
- 默认:
maxResults=20
- 允许的最大值:
maxResults=100.
|
|
pageToken |
用于指定要返回的结果页面的令牌。 |
|
|
parent |
指定任务的父任务 ID。 |
|
|
previous |
指定任务的上一个任务 ID。 |
|
|
showCompleted |
指定是否显示已完成的任务。 |
|
|
showDeleted |
指定是否显示已删除的任务。 |
|
|
showHidden |
指定是否显示隐藏的任务。 |
|
|
updatedMin |
任务上次修改时间的下限(以 RFC 3339 时间戳为准)。 |
- 使用 RFC 3339 时间戳格式。例如:
2010-08-09T10:57:00.000-08:00Z 。
- 默认为不按上次修改时间进行过滤。
|
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-29。
[null,null,["最后更新时间 (UTC):2025-08-29。"],[],[],null,["# Use Tasks Parameters\n\nIn addition to the standard query parameters that can be used with most Google APIs, there is a set of Tasks parameters.\n\nRequest parameters that apply only to specific operations in the Google Tasks API are summarized in the following table. All parameter values need to be URL encoded.\n\n| Parameter | Meaning | Notes | Applicability |\n|-----------------|------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|\n| `completedMax` | Upper bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `completedMin` | Lower bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMax` | Upper bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMin` | Lower bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `maxResults` | The maximum number of elements to return with this request. | - Default: `maxResults=20` - Maximum allowable value: `maxResults=100.` | - Retrieving a user's task lists - Retrieving tasks |\n| `pageToken` | Token specifying the result page to return. | - The default is to return the first page. | - Retrieving a user's task lists - Retrieving tasks |\n| `parent` | Specify the task's parent task ID. | - No parameter indicates an insertion or a move to the top level of the task list. | - Creating a task - Ordering a task |\n| `previous` | Specify the task's previous task ID. | - No parameter indicates an insertion or a move to the first position in the sublist. | - Creating a task - Ordering a task |\n| `showCompleted` | Specify whether or not to show completed tasks. | - Default: `showCompleted=true` | - Retrieving tasks |\n| `showDeleted` | Specify whether or not to show deleted tasks. | - Default: `showDeleted=false` | - Retrieving tasks |\n| `showHidden` | Specify whether or not to show hidden tasks. | - Default: `showHidden=true` | - Retrieving tasks |\n| `updatedMin` | Lower bound for a task's last modification time (as an RFC 3339 timestamp) to filter by. | - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00Z`. - The default is not to filter by last modification time. | - Retrieving tasks |"]]