This is the legacy documentation for Google Ads scripts. Go to the current docs.

Google Tasks

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.
  Logger.log('Name: %s (%s)', taskList.title,;

  // Retrieve all the tasks in the list.
  var tasks = Tasks.Tasks.list(TASK_LIST_ID);

  for (var i = 0; i < tasks.items.length; i++) {
    Logger.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);
  Logger.log('Task with title = %s, id = %s and notes = %s was created. ' +
             'Task is due on %s.',
             newTask.title,, newTask.notes, newTask.due);

Mark task as completed

function markTaskAsCompleted() {
  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);
  Logger.log('Task with title = %s, id = %s and notes = %s was marked ' +
             'as complete.', updatedTask.title,,