Integrate Google Tasks into your workflow. Create, read, update, delete, and list tasks and task lists.
Create a new task in a Google Tasks list
| 参数 | 类型 | 必填 | 描述 |
|---|
taskListId | string | 否 | Task list ID (defaults to primary task list "@default") |
title | string | 是 | Title of the task (max 1024 characters) |
notes | string | 否 | Notes/description for the task (max 8192 characters) |
due | string | 否 | Due date in RFC 3339 format (e.g., 2025-06-03T00:00:00.000Z) |
status | string | 否 | Task status: "needsAction" or "completed" |
parent | string | 否 | Parent task ID to create this task as a subtask. Omit for top-level tasks. |
previous | string | 否 | Previous sibling task ID to position after. Omit to place first among siblings. |
| 参数 | 类型 | 描述 |
|---|
id | string | Task ID |
title | string | Task title |
notes | string | Task notes |
status | string | Task status (needsAction or completed) |
due | string | Due date |
updated | string | Last modification time |
selfLink | string | URL for the task |
webViewLink | string | Link to task in Google Tasks UI |
parent | string | Parent task ID |
position | string | Position among sibling tasks |
completed | string | Completion date |
deleted | boolean | Whether the task is deleted |
List all tasks in a Google Tasks list
| 参数 | 类型 | 必填 | 描述 |
|---|
taskListId | string | 否 | Task list ID (defaults to primary task list "@default") |
maxResults | number | 否 | Maximum number of tasks to return (default 20, max 100) |
pageToken | string | 否 | Token for pagination |
showCompleted | boolean | 否 | Whether to show completed tasks (default true) |
showDeleted | boolean | 否 | Whether to show deleted tasks (default false) |
showHidden | boolean | 否 | Whether to show hidden tasks (default false) |
dueMin | string | 否 | Lower bound for due date filter (RFC 3339 timestamp) |
dueMax | string | 否 | Upper bound for due date filter (RFC 3339 timestamp) |
completedMin | string | 否 | Lower bound for task completion date (RFC 3339 timestamp) |
completedMax | string | 否 | Upper bound for task completion date (RFC 3339 timestamp) |
updatedMin | string | 否 | Lower bound for last modification time (RFC 3339 timestamp) |
| 参数 | 类型 | 描述 |
|---|
tasks | array | List of tasks |
↳ id | string | Task identifier |
↳ title | string | Title of the task |
↳ notes | string | Notes/description for the task |
↳ status | string | Task status: "needsAction" or "completed" |
↳ due | string | Due date (RFC 3339 timestamp) |
↳ completed | string | Completion date (RFC 3339 timestamp) |
↳ updated | string | Last modification time (RFC 3339 timestamp) |
↳ selfLink | string | URL pointing to this task |
↳ webViewLink | string | Link to task in Google Tasks UI |
↳ parent | string | Parent task identifier |
↳ position | string | Position among sibling tasks (string-based ordering) |
↳ hidden | boolean | Whether the task is hidden |
↳ deleted | boolean | Whether the task is deleted |
↳ links | array | Collection of links associated with the task |
↳ type | string | Link type (e.g., "email", "generic", "chat_message") |
↳ description | string | Link description |
↳ link | string | The URL |
nextPageToken | string | Token for retrieving the next page of results |
Retrieve a specific task by ID from a Google Tasks list
| 参数 | 类型 | 必填 | 描述 |
|---|
taskListId | string | 否 | Task list ID (defaults to primary task list "@default") |
taskId | string | 是 | The ID of the task to retrieve |
| 参数 | 类型 | 描述 |
|---|
id | string | Task ID |
title | string | Task title |
notes | string | Task notes |
status | string | Task status (needsAction or completed) |
due | string | Due date |
updated | string | Last modification time |
selfLink | string | URL for the task |
webViewLink | string | Link to task in Google Tasks UI |
parent | string | Parent task ID |
position | string | Position among sibling tasks |
completed | string | Completion date |
deleted | boolean | Whether the task is deleted |
Update an existing task in a Google Tasks list
| 参数 | 类型 | 必填 | 描述 |
|---|
taskListId | string | 否 | Task list ID (defaults to primary task list "@default") |
taskId | string | 是 | The ID of the task to update |
title | string | 否 | New title for the task |
notes | string | 否 | New notes for the task |
due | string | 否 | New due date in RFC 3339 format |
status | string | 否 | New status: "needsAction" or "completed" |
| 参数 | 类型 | 描述 |
|---|
id | string | Task ID |
title | string | Task title |
notes | string | Task notes |
status | string | Task status (needsAction or completed) |
due | string | Due date |
updated | string | Last modification time |
selfLink | string | URL for the task |
webViewLink | string | Link to task in Google Tasks UI |
parent | string | Parent task ID |
position | string | Position among sibling tasks |
completed | string | Completion date |
deleted | boolean | Whether the task is deleted |
Delete a task from a Google Tasks list
| 参数 | 类型 | 必填 | 描述 |
|---|
taskListId | string | 否 | Task list ID (defaults to primary task list "@default") |
taskId | string | 是 | The ID of the task to delete |
| 参数 | 类型 | 描述 |
|---|
taskId | string | Deleted task ID |
deleted | boolean | Whether deletion was successful |
Retrieve all task lists for the authenticated user
| 参数 | 类型 | 必填 | 描述 |
|---|
maxResults | number | 否 | Maximum number of task lists to return (default 20, max 100) |
pageToken | string | 否 | Token for pagination |
| 参数 | 类型 | 描述 |
|---|
taskLists | array | List of task lists |
↳ id | string | Task list identifier |
↳ title | string | Title of the task list |
↳ updated | string | Last modification time (RFC 3339 timestamp) |
↳ selfLink | string | URL pointing to this task list |
nextPageToken | string | Token for retrieving the next page of results |
