使用任务参数

除了可与大多数 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 指定是否显示已完成的任务。
  • 默认：showCompleted=true
  • 检索任务
showDeleted 指定是否显示已删除的任务。
  • 默认：showDeleted=false
  • 检索任务
showHidden 指定是否显示隐藏的任务。
  • 默认：showHidden=true
  • 检索任务
updatedMin 任务上次修改时间的下限（以 RFC 3339 时间戳为准）。
  • 使用 RFC 3339 时间戳格式。例如：2010-08-09T10:57:00.000-08:00Z。
  • 默认为不按上次修改时间进行过滤。
  • 检索任务