> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Tasks

> 一个简单的待办事项列表和任务管理应用，可通过你已连接的账号在列表中整理任务。

# Google Tasks

当你需要在工作流中管理 Google Tasks 列表或任务时，可以使用此应用。你可以创建、读取、更新、移动和清除项目。

## 配置

| 选项 | 必填 | 说明 |
| - | - | - |
| 名称 | 否 | 工作流画布中该步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Google Tasks 账号。 |
| Action | 是 | 要执行的 Google Tasks 操作（例如 List task lists、Get task list、Create task list、Rename task list）。 |
| Arguments | 是 | 由该操作的架构生成的逐操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，用于注入 `{{placeholder}}` 值。可切换到 **Raw JSON** 选项卡进行高级用法。 |
| When the step fails | 否 | 控制此步骤失败时，工作流应是 **Terminate Workflow** 还是 **Continue**。 |

在配置此步骤之前，请先在工作区的 **Integrations** 中通过登录流程连接 Google Tasks。如果没有可用的活动连接，此步骤会显示一个警告，并提供指向 **Integrations** 的链接，而不是账号选择器。

## Arguments 表单

当你选择某个操作时，**Arguments** 部分会根据该操作的输入架构渲染一个表单。引用现有记录的字段包含下拉选择器。

如果你更希望手动编写完整的参数对象，可以切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## 常见操作

| 操作 | 说明 |
| - | - |
| **List task lists** | 获取已通过身份验证的用户的任务列表。 |
| **Get task list** | 检索一个特定的任务列表。 |
| **Create task list** | 创建一个新的任务列表。 |
| **Rename task list** | 更新某个任务列表的标题。 |
| **Replace task list** | 完全替换一个任务列表标题。 |
| **List tasks** | 获取特定任务列表中的任务。 |
| **List all tasks** | 获取所有任务列表中的任务。 |
| **Get task** | 检索一个特定任务。 |
| **Create task** | 在任务列表中创建一个新任务。 |
| **Update task** | 部分更新现有任务。 |
| **Replace task** | 完全替换现有任务。 |
| **Move task** | 在列表内或列表之间移动任务。 |

删除记录等破坏性操作在工作流操作选择器中不可用。

## 输出

此步骤会将 Google Tasks 响应存储为步骤输出。响应的结构取决于所选操作。

在后续步骤中使用完整输出引用：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## 示例

1. 打开 **Integrations**，如果你还没有连接过 Google Tasks，请先连接。
2. 向工作流添加一个 **Google Tasks** 步骤。
3. 在 **Authentication** 中选择一个已连接账号。
4. 在 **Action** 中选择 **List task lists**。
5. 填写必填字段。使用 **Insert Variable** 引用上一步的输出作为任意字段值。
6. 点击步骤标题中的 **Run** 测试该操作，然后在 **Output** 中查看返回的载荷。

## 使用场景

### 添加跟进任务

1. List task lists
2. Create task
3. Get task

### 重命名列表

1. List task lists
2. Get task list
3. Rename task list

### 清理已完成项目

1. List task lists
2. List tasks
3. Clear completed

## 说明

* 此步骤依赖于你工作区中已连接的 Google Tasks 集成。
* 工作流操作选择器会显示一组精选操作。具有 Google Tasks 工具的代理可以使用更多操作。
* 登录界面可能会显示第三方授权品牌标识。

## 将 Google Tasks 用作代理工具

你也可以在 **Agent Editor** 中将 Google Tasks 添加为工具。打开代理，点击 **Add tool**，然后选择 **Google Tasks**。在工具设置面板中，选择代理应使用的已连接账号。代理会在相关于对话时调用 Google Tasks 操作。

另请参阅：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)、[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.