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