Google Tasks
Stay organized with collections
Save and categorize content based on your preferences.
Get tasks from task list
function
getTasksFromDefaultList
()
{
//
You
can
substitute
a
task
list
ID
here
to
retrieve
all
the
tasks
//
in
that
list
.
var
TASK_LIST_ID
=
'@default'
;
var
taskList
=
Tasks
.
Tasklists
.
get
(
TASK_LIST_ID
);
//
Display
the
task
list
details
.
console
.
log
(
'Name: %s (%s)'
,
taskList
.
title
,
taskList
.
id
);
//
Retrieve
all
the
tasks
in
the
list
.
var
tasks
=
Tasks
.
Tasks
.
list
(
TASK_LIST_ID
);
for
(
var
i
=
0
;
i
<
tasks
.
items
.
length
;
i
++
)
{
console
.
log
(
' %s) Title: %s, Due on: %s, Status: %s, ID = %s.'
,
i
.
toFixed
(
0
),
tasks
.
items
[
i
]
.
title
,
tasks
.
items
[
i
]
.
due
?
tasks
.
items
[
i
]
.
due
:
'Never'
,
tasks
.
items
[
i
]
.
status
,
tasks
.
items
[
i
]
.
id
);
}
}
Create a task
function
createTask
()
{
//
You
can
substitute
a
task
list
ID
here
to
create
the
task
in
a
//
specific
list
.
var
TASK_LIST_ID
=
'@default'
;
var
task
=
Tasks
.
newTask
();
task
.
title
=
'Run reports'
;
task
.
notes
=
'Run account performance report in 5 days.'
;
var
dueDate
=
new
Date
();
dueDate
.
setDate
(
dueDate
.
getDate
()
+
5
);
task
.
due
=
dueDate
.
toISOString
();
var
newTask
=
Tasks
.
Tasks
.
insert
(
task
,
TASK_LIST_ID
);
console
.
log
(
'Task with title =
%s
, id =
%s
and notes =
%s
was created. '
+
'Task is due on
%s
.'
,
newTask
.
title
,
newTask
.
id
,
newTask
.
notes
,
newTask
.
due
);
}
Mark task as completed
function
markTaskAsCompleted
()
{
var
TASK_ID
=
'INSERT_TASK_ID_HERE'
;
var
TASK_LIST_ID
=
'@default'
;
//
Retrieve
the
task
.
var
task
=
Tasks
.
Tasks
.
get
(
TASK_LIST_ID
,
TASK_ID
);
task
.
status
=
'completed'
;
var
updatedTask
=
Tasks
.
Tasks
.
update
(
task
,
TASK_LIST_ID
,
TASK_ID
);
console
.
log
(
'Task with title =
%s
, id =
%s
and notes =
%s
was marked '
+
'as complete.'
,
updatedTask
.
title
,
updatedTask
.
id
,
updatedTask
.
notes
);
}
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-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThe code demonstrates how to retrieve tasks from the default Google Tasks list, including details like title, due date, status, and ID.\u003c/p\u003e\n"],["\u003cp\u003eIt showcases the creation of a new task with a title, notes, and a due date set for 5 days from the current date.\u003c/p\u003e\n"],["\u003cp\u003eThe provided example illustrates how to mark a task as completed by updating its status using the task ID and task list ID.\u003c/p\u003e\n"]]],[],null,["# Google Tasks\n\nGet tasks from task list\n------------------------\n\n```transact-sql\nfunction getTasksFromDefaultList() {\n // You can substitute a task list ID here to retrieve all the tasks\n // in that list.\n\n var TASK_LIST_ID = '@default';\n\n var taskList = Tasks.Tasklists.get(TASK_LIST_ID);\n\n // Display the task list details.\n console.log('Name: %s (%s)', taskList.title, taskList.id);\n\n // Retrieve all the tasks in the list.\n var tasks = Tasks.Tasks.list(TASK_LIST_ID);\n\n for (var i = 0; i \u003c tasks.items.length; i++) {\n console.log(' %s) Title: %s, Due on: %s, Status: %s, ID = %s.',\n i.toFixed(0), tasks.items[i].title,\n tasks.items[i].due ? tasks.items[i].due : 'Never',\n tasks.items[i].status, tasks.items[i].id);\n }\n}\n```\n\nCreate a task\n-------------\n\n```gdscript\nfunction createTask() {\n // You can substitute a task list ID here to create the task in a\n // specific list.\n\n var TASK_LIST_ID = '@default';\n\n var task = Tasks.newTask();\n task.title = 'Run reports';\n task.notes = 'Run account performance report in 5 days.';\n\n var dueDate = new Date();\n dueDate.setDate(dueDate.getDate() + 5);\n task.due = dueDate.toISOString();\n\n var newTask = Tasks.Tasks.insert(task, TASK_LIST_ID);\n console.log('Task with title = %s, id = %s and notes = %s was created. ' +\n 'Task is due on %s.',\n newTask.title, newTask.id, newTask.notes, newTask.due);\n}\n```\n\nMark task as completed\n----------------------\n\n```gdscript\nfunction markTaskAsCompleted() {\n var TASK_ID = 'INSERT_TASK_ID_HERE';\n var TASK_LIST_ID = '@default';\n\n // Retrieve the task.\n var task = Tasks.Tasks.get(TASK_LIST_ID, TASK_ID);\n task.status = 'completed';\n\n var updatedTask = Tasks.Tasks.update(task, TASK_LIST_ID, TASK_ID);\n console.log('Task with title = %s, id = %s and notes = %s was marked ' +\n 'as complete.', updatedTask.title, updatedTask.id,\n updatedTask.notes);\n}\n```"]]
