> ## 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.

# YouTube

> 通过已连接的账号管理 YouTube 内容、播放列表和评论。

# YouTube

当你需要发布内容、整理播放列表或管理视频评论时，可以使用 YouTube。只要你的工作流里有可用的视频 ID、播放列表 ID、评论 ID 或文本，就可以把它作为一个步骤添加进来。

## 配置

| 选项 | 必填 | 描述 |
| - | - | - |
| 名称 | 否 | 该步骤在工作流画布中的标签。 |
| **Authentication** | 是 | 此步骤要使用的已连接 YouTube 账号。 |
| **Action** | 是 | 要执行的 YouTube 操作（例如 获取视频详情、搜索视频、上传视频、更新视频）。 |
| **Arguments** | 是 | 根据操作的 schema 生成的每个操作对应的表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于插入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| 当步骤失败时 | 否 | 控制此步骤失败时，工作流应 **Terminate Workflow** 还是 **Continue**。 |

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

## Arguments form

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

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

## 常用操作

| 操作 | 描述 |
| - | - |
| **Get video details** | 通过 ID 获取一个或多个视频的详细元数据。 |
| **Search videos** | 按查询搜索视频、频道或播放列表。 |
| **Upload video** | 将视频文件连同元数据和隐私设置上传到频道。 |
| **Update video** | 更新现有视频的元数据。 |
| **Update thumbnail** | 从图片 URL 为视频设置自定义缩略图。 |
| **List playlist items** | 列出播放列表中的视频。 |
| **Create playlist** | 在已连接的频道上创建新的播放列表。 |
| **Update playlist** | 更新播放列表的元数据和隐私设置。 |
| **Add video to playlist** | 将视频插入播放列表。 |
| **Update playlist item** | 更改播放列表项的位置或备注。 |
| **List comment threads** | 列出视频或频道的评论线程。 |
| **Post comment** | 在视频上发布新的顶层评论。 |
| **Insert comment reply** | 回复现有评论。 |
| **Update comment** | 编辑现有评论的文本。 |
| **Set moderation status** | 批准、拒绝或将评论标记为待审核。 |

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

## 输出

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

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

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

## 示例

1. 打开 **Integrations**，如果你还没有连接 YouTube，就先连接它。
2. 将一个 **YouTube** 步骤添加到你的工作流中。
3. 在 **Authentication** 中选择一个已连接账号。
4. 在 **Action** 中选择 **Get video details**。
5. 填写必填字段。使用 **Insert Variable** 通过前一步的输出来引用任意字段值。
6. 点击步骤标题栏中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的有效载荷。

## 使用场景

### 发布新视频

1. 上传视频
2. 更新缩略图
3. 更新视频

### 整理播放列表

1. 创建播放列表
2. 将视频添加到播放列表
3. 更新播放列表

### 管理评论

1. 列出评论线程
2. 设置审核状态
3. 插入评论回复

## 注意事项

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

## 将 YouTube 用作代理工具

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

另请参阅：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)、[创建和编辑](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [测试与迭代](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.