使用 Google Tasks 参数

除了可用于大多数 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
  • 默认情况下,不按上次修改时间进行过滤。
  • 检索任务