In addition to the standard query parameters that can be used with most Google APIs, there is a set of Tasks parameters.
Request parameters that apply only to specific operations in the Google Tasks API are summarized in the following table: All parameter values must 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
- Retrieving tasks
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
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
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
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
pageToken
Token specifying the result page to return.
- The default is to return the first page.
- Retrieving a user's task lists
- Retrieving tasks
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
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
showCompleted
Specify whether or not to show completed tasks.
- Default:
showCompleted=true
- Retrieving tasks
showDeleted
Specify whether or not to show deleted tasks.
- Default:
showDeleted=false
- Retrieving tasks
showHidden
Specify whether or not to show hidden tasks.
- Default:
showHidden=true
- Retrieving tasks
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
