Overview
Stay organized with collections
Save and categorize content based on your preferences.
The Google Tasks API lets you search, read, and update Google Tasks content and metadata. This document describes how to use a RESTful calling style and client libraries for various programming languages (currently Java, Python, and PHP) to access and edit Google Tasks data.
Sites or applications that want deeper integration with Google Tasks can leverage the Google Tasks API. For example, you could use the Google Tasks API to manage Google task lists in a mobile app, or you could integrate tasks into a more extensive workflow app such as Au-to-do.
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[],[],null,["# Overview\n\nThe Google Tasks API lets you search, read, and update Google Tasks content and metadata. This document describes how to use a RESTful calling style and client libraries for various programming languages (currently Java, Python, and PHP) to access and edit Google Tasks data.\n\nSites or applications that want deeper integration with Google Tasks can leverage the Google Tasks API. For example, you could use the Google Tasks API to manage Google task lists in a mobile app, or you could integrate tasks into a more extensive workflow app such as [Au-to-do](http://code.google.com/p/au-to-do/).\n\nGoogle Tasks is built on two basic concepts:\n\nTask List\n: A list containing tasks. Users can have more than one task list to manage their tasks the way they want.\n\nTask\n: A single task containing information such as the title of the task, notes, the due date, and the completed date.\n\n### Tasks API data model\n\nA resource is an individual data entity with a unique identifier. The Google Tasks API operates on two types of resources:\n\nTask List Resource\n: Represents a task list.\n\nTask Resource\n: Represents a task.\n\nThe Tasks API data model is based on groups of resources, called collections:\n\nTask List Collection\n: Each user has at least one `default` Task List.\n\nTask Collection\n: Consists of all the Task Resources within a specific Task List Resource."]]
