Tasks Concepts

Stay organized with collections Save and categorize content based on your preferences.

Google Tasks is built on two basic concepts:

Task List
A list containing tasks. Users can have more than one task list to manage their tasks the way they want.
A single task containing information such as the title of the task, notes, the due date, and the completed date.

Tasks API data model

A resource is an individual data entity with a unique identifier. The Google Tasks API operates on two types of resources:

Task List Resource
Represents a task list.
Task Resource
Represents a task.

The Tasks API data model is based on groups of resources, called collections:

Task List Collection
Each user has at least one default Task List.
Task Collection
Consists of all the Task Resources within a specific Task List Resource.

Tasks API operations

You can invoke five different methods on collections and resources in the Google Tasks API, as described in the following table.

Operation Description REST HTTP mappings
list Lists all resources within a collection. GET on a collection URI.
insert Creates a new resource and inserts it into a collection. POST on a collection URI, where you pass in data for a new resource.
get Gets a specific resource. GET on a resource URI.
update Updates a specific resource. PUT on a resource URI, where you pass in data for the updated resource.
delete Delete a specific resource. DELETE on a resource URI.