Google Tasks

The Google Tasks modules enable you to monitor, retrieve, create, update, or delete tasks and task lists in your Google Tasks.

Getting Started with Google Tasks

Prerequisites

  • A Google account

In order to use Google Tasks with Make, it is necessary to have a Google Tasks account. If you do not have one, you can create a Google Tasks account at Google Tasks.

Caution

The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!

Connecting Google Tasks to Make

To connect your Google Tasks account to Make follow the general instructions for Connecting to services.

After you click the Continue button, Make will redirect you to the Google Tasks website where you will be prompted to grant Make access to your account.

61d5b570b2d5b.png

Confirm the dialog by clicking the Allow button.

Task

Watch Tasks

Retrieves task details when a task is created and updated, due, or completed.

Connection

Establish a connection to your Google account.

Watch Tasks

Select the change that will return the tasks.

Show Completed Tasks

Enable this option to include also completed tasks in the module's output.

Task List ID

Select the task list you want to watch for changes.

Limit

Set the maximum number of tasks Make will return during one execution cycle.

List Tasks

Retrieves tasks in the specified task list by the filter settings.

Connection

Establish a connection to your Google account.

Task List ID

Map the task list ID or select the task list you want to retrieve tasks from.

To Completed Date

Enter the upper bound for a task's completion date to filter by. The list of supported date and time formats.

To Completed Date

Enter the lower bound for a task's completion date to filter by. The list of supported date and time formats.

From Due Date

Enter the exclusive upper bound for a task's due date to filter by. The list of supported date and time formats.

To Due Date

Enter inclusive lower bound for a task's due date to filter by. Filtering is by date only; hours and minutes are not used. The list of supported date and time formats.

Show Completed Tasks

Enable this option to include also completed tasks in the module's output.

Show Deleted Tasks

Enable this option to include deleted tasks in the module's output.

From Updated Time

Enter the lower bound for a task's last modification time to filter by. The list of supported date and time formats.

Limit

Set the maximum number of tasks Make will return during one execution cycle.

Get a Task

Retrieves task details.

Connection

Establish a connection to your Google account.

Task List ID

Map the Task List ID or select the task list you want to retrieve the task from.

Task ID

Map or select the ID of the task you want to retrieve details about.

Create a Task

Creates a new task in the specified task list.

Connection

Establish a connection to your Google account.

Task List ID

Map the Task List ID or select the task list you want to create a new task for.

Select the Method

Select whether you want to create a task or subtask.

Parent Task

Select the parent task of the new subtask.

Title

Enter the title for the new task.

Notes

Enter the notes describing the task.

Due Date

Enter the due date of the task. The list of supported date and time formats.

Update a Task

Updates an existing task.

Connection

Establish a connection to your Google account.

Task List ID

Map the Task List ID or select the task list you want to update a task for.

Task

Map the Task ID or select the task you want to update.

Title

Enter the new title for the task.

Notes

Enter the notes describing the task.

Due Date

Enter the due date of the task. The list of supported date and time formats.

Complete Task

Enable this option to mark the task as completed.

Delete a Task

Deletes an existing task.

Connection

Establish a connection to your Google account.

Task List ID

Map the Task List ID or select the task list that contains the task you want to delete.

Task

Map the Task ID or select the task you want to delete.

Task Lists

Watch Task Lists

Retrieve task list details when a task list is created or updated.

Connection

Establish a connection to your Google account.

Limit

Set the maximum number of tasks lists Make will return during one execution cycle.

List Task Lists

Retrieves all tasks lists in your account.

Connection

Establish a connection to your Google account.

Limit

Set the maximum number of tasks lists Make will return during one execution cycle.

Get a Task List

Retrieves task list details.

Connection

Establish a connection to your Google account.

Task List ID

Map the Task List ID or select the task list you want to retrieve details about.

Create a Task List

Creates a new task list in your account.

The maximum number of 2000 task lists is allowed.

Connection

Establish a connection to your Google account.

Title

Enter the title of the task list.

Update a Task List

Updates the title of an existing task list.

Connection

Establish a connection to your Google account.

Task List ID

Map the Task List ID or select the task list you want to update.

Title

Enter the new title for the task list.

Delete a Task List

Deletes a task list.

Connection

Establish a connection to your Google account.

Task List ID

Map the task list ID or select the task list you want to delete.

Other

Make an API Call

Allows you to perform a custom API call.

Connection

Establish a connection to your Google account.

URL

Enter a path relative to https://www.googleapis.com/tasks

E.g. /v1/users/@me/lists

For the list of available endpoints, refer to the Google Tasks API Documentation.

Method

Select the HTTP method you want to use:

  • GET - to retrieve information for an entry.

  • POST - to create a new entry.

  • PUT - to update/replace an existing entry.

  • PATCH - to make a partial entry update.

  • DELETE - to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Tasks From the Task List

The following API call returns the tasks from the specified task list:

URL:

/v1/lists/{{TaskListID}}/tasks

Method:

GET

61d5b571ee65f.png

Matches of the search can be found in the module's Output under Bundle > Body > items.

In our example, 7 tasks were returned:

61d5b57309682.png