Google Tasks
Google Tasks is a cloud-based task management tool that allows users to create, edit, and organize to-do lists, set deadlines, and track tasks across devices in real-time.
Categories: Productivity and Collaboration
Type: googleTasks/v1
Connections
Version: 1
OAuth2 Authorization Code
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| clientId | Client Id | STRING | true | |
| clientSecret | Client Secret | STRING | true |
Connection Setup
Create OAuth 2.0 Application
Creation of OAuth 2.0 application is documented here.
Enable Google Tasks API
- In the Google Cloud Console, select your project.
- Go to the APIs & Services.
- Click on ENABLE APIS AND SERVICES.
- Search for "google tasks api" in the search bar.
- Click on Google Tasks API.
- Click Enable.
Actions
Create Task
Name: createTask
Creates a new task on the specified task list.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| title | Title | STRING | Title of the new task to be created. | true |
| listId | List ID | STRING | ID of the list where the new task will be stored. | true |
| status | Status | STRING OptionsneedsAction, completed | Status of the task. | true |
| notes | Notes | STRING | Notes describing the task. | false |
Example JSON Structure
{
"label" : "Create Task",
"name" : "createTask",
"parameters" : {
"title" : "",
"listId" : "",
"status" : "",
"notes" : ""
},
"type" : "googleTasks/v1/createTask"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| kind | STRING | Type of the resource. |
| id | STRING | Task identifier. |
| etag | STRING | ETag of the resource. |
| title | STRING | Title of the task. Maximum length allowed: 1024 characters. |
| updated | STRING | Last modification time of the task (as a RFC 3339 timestamp). |
| selfLink | STRING | URL pointing to this task. Used to retrieve, update, or delete this task. |
| parent | STRING | Parent task identifier. |
| position | STRING | String indicating the position of the task among its sibling tasks under the same parent task or at the top level. |
| notes | STRING | Notes describing the task. |
| status | STRING | Status of the task. |
| due | STRING | Scheduled date for the task (as an RFC 3339 timestamp). |
| completed | STRING | Completion date of the task (as a RFC 3339 timestamp). |
| deleted | BOOLEAN Optionstrue, false | Flag indicating whether the task has been deleted. |
| hidden | BOOLEAN Optionstrue, false | Flag indicating whether the task is hidden. |
| links | ARRAY Items[{STRING(type), STRING(description), STRING(link)}] | Collection of links. |
| webViewLink | STRING | An absolute link to the task in the Google Tasks Web UI. |
| assignmentInfo | OBJECT Properties{STRING(linkToTask), STRING(surfaceType), {}(DriveResourceInfo), {}(spaceInfo)} | Context information for assigned tasks. |
Output Example
{
"kind" : "",
"id" : "",
"etag" : "",
"title" : "",
"updated" : "",
"selfLink" : "",
"parent" : "",
"position" : "",
"notes" : "",
"status" : "",
"due" : "",
"completed" : "",
"deleted" : false,
"hidden" : false,
"links" : [ {
"type" : "",
"description" : "",
"link" : ""
} ],
"webViewLink" : "",
"assignmentInfo" : {
"linkToTask" : "",
"surfaceType" : "",
"DriveResourceInfo" : { },
"spaceInfo" : { }
}
}Find List ID
To find List ID, click here
List Tasks
Name: listTasks
Returns all tasks in the specified task list.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| listId | List ID | STRING | ID of the list where tasks are stored. | true |
| showCompleted | Show completed | BOOLEAN Optionstrue, false | Show also completed tasks. By default both completed task and task that needs action will be shown. | true |
Example JSON Structure
{
"label" : "List Tasks",
"name" : "listTasks",
"parameters" : {
"listId" : "",
"showCompleted" : false
},
"type" : "googleTasks/v1/listTasks"
}Output
Type: ARRAY
Items Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| kind | STRING | Type of the resource. |
| id | STRING | Task identifier. |
| etag | STRING | ETag of the resource. |
| title | STRING | Title of the task. Maximum length allowed: 1024 characters. |
| updated | STRING | Last modification time of the task (as a RFC 3339 timestamp). |
| selfLink | STRING | URL pointing to this task. Used to retrieve, update, or delete this task. |
| parent | STRING | Parent task identifier. |
| position | STRING | String indicating the position of the task among its sibling tasks under the same parent task or at the top level. |
| notes | STRING | Notes describing the task. |
| status | STRING | Status of the task. |
| due | STRING | Scheduled date for the task (as an RFC 3339 timestamp). |
| completed | STRING | Completion date of the task (as a RFC 3339 timestamp). |
| deleted | BOOLEAN Optionstrue, false | Flag indicating whether the task has been deleted. |
| hidden | BOOLEAN Optionstrue, false | Flag indicating whether the task is hidden. |
| links | ARRAY Items[{STRING(type), STRING(description), STRING(link)}] | Collection of links. |
| webViewLink | STRING | An absolute link to the task in the Google Tasks Web UI. |
| assignmentInfo | OBJECT Properties{STRING(linkToTask), STRING(surfaceType), {}(DriveResourceInfo), {}(spaceInfo)} | Context information for assigned tasks. |
Output Example
[ {
"kind" : "",
"id" : "",
"etag" : "",
"title" : "",
"updated" : "",
"selfLink" : "",
"parent" : "",
"position" : "",
"notes" : "",
"status" : "",
"due" : "",
"completed" : "",
"deleted" : false,
"hidden" : false,
"links" : [ {
"type" : "",
"description" : "",
"link" : ""
} ],
"webViewLink" : "",
"assignmentInfo" : {
"linkToTask" : "",
"surfaceType" : "",
"DriveResourceInfo" : { },
"spaceInfo" : { }
}
} ]Find List ID
To find List ID, click here
Update Task
Name: updateTask
Updates a specific task on the specified task list.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| listId | List ID | STRING | ID of the list where specific task is stored. | true |
| taskId | Task ID | STRING Depends OnlistId | ID of the task to update. | true |
| title | Title | STRING | Title of the task to be updated. If empty, title will not be changed. | false |
| status | Status | STRING OptionsneedsAction, completed | Status of the task. If empty, status will not be changed. | false |
| notes | Notes | STRING | Notes describing the task. If empty, notes will not be changed. | false |
Example JSON Structure
{
"label" : "Update Task",
"name" : "updateTask",
"parameters" : {
"listId" : "",
"taskId" : "",
"title" : "",
"status" : "",
"notes" : ""
},
"type" : "googleTasks/v1/updateTask"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| kind | STRING | Type of the resource. |
| id | STRING | Task identifier. |
| etag | STRING | ETag of the resource. |
| title | STRING | Title of the task. Maximum length allowed: 1024 characters. |
| updated | STRING | Last modification time of the task (as a RFC 3339 timestamp). |
| selfLink | STRING | URL pointing to this task. Used to retrieve, update, or delete this task. |
| parent | STRING | Parent task identifier. |
| position | STRING | String indicating the position of the task among its sibling tasks under the same parent task or at the top level. |
| notes | STRING | Notes describing the task. |
| status | STRING | Status of the task. |
| due | STRING | Scheduled date for the task (as an RFC 3339 timestamp). |
| completed | STRING | Completion date of the task (as a RFC 3339 timestamp). |
| deleted | BOOLEAN Optionstrue, false | Flag indicating whether the task has been deleted. |
| hidden | BOOLEAN Optionstrue, false | Flag indicating whether the task is hidden. |
| links | ARRAY Items[{STRING(type), STRING(description), STRING(link)}] | Collection of links. |
| webViewLink | STRING | An absolute link to the task in the Google Tasks Web UI. |
| assignmentInfo | OBJECT Properties{STRING(linkToTask), STRING(surfaceType), {}(DriveResourceInfo), {}(spaceInfo)} | Context information for assigned tasks. |
Output Example
{
"kind" : "",
"id" : "",
"etag" : "",
"title" : "",
"updated" : "",
"selfLink" : "",
"parent" : "",
"position" : "",
"notes" : "",
"status" : "",
"due" : "",
"completed" : "",
"deleted" : false,
"hidden" : false,
"links" : [ {
"type" : "",
"description" : "",
"link" : ""
} ],
"webViewLink" : "",
"assignmentInfo" : {
"linkToTask" : "",
"surfaceType" : "",
"DriveResourceInfo" : { },
"spaceInfo" : { }
}
}Find List ID
To find List ID, click here
Find Task ID
To find Task ID, click here
Triggers
New Task
Name: newTask
Triggers when a new task is added.
Type: POLLING
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| listId | List ID | STRING | ID of the list where new task is added. | true |
Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| kind | STRING | Type of the resource. |
| id | STRING | Task identifier. |
| etag | STRING | ETag of the resource. |
| title | STRING | Title of the task. Maximum length allowed: 1024 characters. |
| updated | STRING | Last modification time of the task (as a RFC 3339 timestamp). |
| selfLink | STRING | URL pointing to this task. Used to retrieve, update, or delete this task. |
| parent | STRING | Parent task identifier. |
| position | STRING | String indicating the position of the task among its sibling tasks under the same parent task or at the top level. |
| notes | STRING | Notes describing the task. |
| status | STRING | Status of the task. |
| due | STRING | Scheduled date for the task (as an RFC 3339 timestamp). |
| completed | STRING | Completion date of the task (as a RFC 3339 timestamp). |
| deleted | BOOLEAN Optionstrue, false | Flag indicating whether the task has been deleted. |
| hidden | BOOLEAN Optionstrue, false | Flag indicating whether the task is hidden. |
| links | ARRAY Items[{STRING(type), STRING(description), STRING(link)}] | Collection of links. |
| webViewLink | STRING | An absolute link to the task in the Google Tasks Web UI. |
| assignmentInfo | OBJECT Properties{STRING(linkToTask), STRING(surfaceType), {}(DriveResourceInfo), {}(spaceInfo)} | Context information for assigned tasks. |
JSON Example
{
"label" : "New Task",
"name" : "newTask",
"parameters" : {
"listId" : ""
},
"type" : "googleTasks/v1/newTask"
}Find List ID
To find List ID, click here
What to do if your action is not listed here?
If this component doesn't have the action you need, you can use Custom Action to create your own. Custom Actions empower you to define HTTP requests tailored to your specific requirements, allowing for greater flexibility in integrating with external services or APIs.
To create a Custom Action, simply specify the desired HTTP method, path, and any necessary parameters. This way, you can extend the functionality of your component beyond the predefined actions, ensuring that you can meet all your integration needs effectively.
Additional Instructions
How to find List ID
You can only find List ID by using Google Tasks API endpoint: GET https://tasks.googleapis.com/tasks/v1/users/@me/lists.
How to find Task ID
You can only find Task ID by using Google Tasks API endpoint: GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks.
Troubleshooting
Access Blocked: Verification Process Not Completed
Documentation for how to add a test user can be found here
How is this guide?
Last updated on