Google Tasks API

Tasks

Methods

list
Returns all tasks in the specified task list.
get
Returns the specified task.
insert
Creates a new task on the specified task list.
update
Updates the specified task.
delete
Deletes the specified task from the task list.
clear
Clears all completed tasks from the specified task list. The affected tasks will be marked as 'hidden' and no longer be returned by default when retrieving all tasks for a task list.
move
Moves the specified task to another position in the task list. This can include putting it as a child task under a new parent and/or move it to a different position among its sibling tasks.
patch
Updates the specified task. This method supports patch semantics.

Resource Representations

{
  "kind": "tasks#task",
  "id": string,
  "etag": etag,
  "title": string,
  "updated": datetime,
  "selfLink": string,
  "parent": string,
  "position": string,
  "notes": string,
  "status": string,
  "due": datetime,
  "completed": datetime,
  "deleted": boolean,
  "hidden": boolean,
  "links": [
    {
      "type": string,
      "description": string,
      "link": string
    }
  ]
}
Property Name Value Description Notes
kind string Type of the resource. This is always "tasks#task".
id string Task identifier.
etag etag ETag of the resource.
title string Title of the task.
updated datetime Last modification time of the task (as a RFC 3339 timestamp).
parent string Parent task identifier. This field is omitted if it is a top-level task. This field is read-only. Use the "move" method to move the task under a different parent or to the top level.
position string String indicating the position of the task among its sibling tasks under the same parent task or at the top level. If this string is greater than another task's corresponding position string according to lexicographical ordering, the task is positioned after the other task under the same parent task (or at the top level). This field is read-only. Use the "move" method to move the task to another position.
notes string Notes describing the task. Optional.
status string Status of the task. This is either "needsAction" or "completed".
due datetime Due date of the task (as a RFC 3339 timestamp). Optional.
completed datetime Completion date of the task (as a RFC 3339 timestamp). This field is omitted if the task has not been completed.
deleted boolean Flag indicating whether the task has been deleted. The default if False.
hidden boolean Flag indicating whether the task is hidden. This is the case if the task had been marked completed when the task list was last cleared. The default is False. This field is read-only.
links[].type string Type of the link, e.g. "email".
links[].description string The description. In HTML speak: Everything between <a> and </a>.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.