Google Apps Platform

How to Use Tasks-Specific Parameters

In addition to the standard query parameters that can be used with most Google APIs, there is a set of Tasks-specific parameters.

Request 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.

Parameter Meaning Notes Applicability
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
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
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
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
maxResults The maximum number of elements to return with this request.
  • Default: maxResults=20
  • Maximum allowable value: maxResults=100.
pageToken Token specifying the result page to return.
  • The default is to return the first page.
parent Specify the task's parent task ID.
  • No parameter indicates an insertion or a move to the top level of the task list.
previous Specify the task's previous task ID.
  • No parameter indicates an insertion or a move to the first position in the sublist.
showCompleted Specify whether or not to show completed tasks.
  • Default: showCompleted=true
showDeleted Specify whether or not to show deleted tasks.
  • Default: showDeleted=false
showHidden Specify whether or not to show hidden tasks.
  • Default: showHidden=true
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.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.