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

# Canva

> 通过已连接的帐户创建、管理并导出 Canva 设计、文件夹、素材和评论。

# Canva

当你需要创建或更新设计、移动文件，或导出已完成的素材时，可以使用 Canva。它也适用于整理文件夹和管理设计评论。

## 配置

| 选项 | 是否必填 | 说明 |
| - | - | - |
| Name | 否 | 工作流画布中此步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Canva 帐户。 |
| Action | 是 | 要执行的 Canva 操作（例如 Show account identity、List user designs、Create new design、Get design details）。 |
| Arguments | 是 | 由操作的架构生成的按操作划分的表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于注入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| When the step fails | 否 | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |

在配置此步骤之前，请使用登录流程在工作区的 **Integrations** 中连接 Canva。如果没有可用的活动连接，步骤会显示带有 **Integrations** 链接的警告，而不是帐户选择器。

## Arguments form

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

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

## Common actions

| 操作 | 说明 |
| - | - |
| **Show account identity** | 返回已连接 Canva 帐户的身份信息。 |
| **List user designs** | 列出已连接用户可用的设计。 |
| **Create new design** | 根据预设、尺寸或模板创建一个新的 Canva 设计。 |
| **Get design details** | 获取设计的元数据和访问权限信息。 |
| **Start export job** | 为设计启动一个异步导出任务。 |
| **Get export result** | 检查设计导出任务的状态和结果。 |
| **Import design file** | 将外部文件导入为新的 Canva 设计。 |
| **Check import status** | 检查设计导入任务的状态和结果。 |
| **Upload asset file** | 将文件上传到 Canva 内容库。 |
| **Check upload status** | 检查素材上传任务的状态。 |
| **Get asset details** | 获取已上传素材的元数据。 |
| **Create folder** | 在 Canva 中创建新文件夹。 |
| **Get folder details** | 通过 ID 获取文件夹详情。 |
| **Update folder details** | 更新文件夹名称。 |
| **Move item to folder** | 将设计、素材或其他项目移动到文件夹中。 |

具有破坏性的操作，例如删除记录，在工作流操作选择器中不可用。

## Output

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

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

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

## Example

1. 打开 **Integrations**，如果你还没有连接过 Canva，请先连接。
2. 将一个 **Canva** 步骤添加到你的工作流中。
3. 在 **Authentication** 中选择一个已连接的帐户。
4. 在 **Action** 中选择 **Show account identity**。
5. 填写所需字段。使用 **Insert Variable** 可为任何字段值引用前一步的输出。
6. 点击步骤标题中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的有效负载。

## Use cases

### 从文件创建设计

1. 导入设计文件
2. 检查导入状态
3. 获取设计详情

### 导出已完成的设计

1. 列出用户设计
2. 启动导出任务
3. 获取导出结果

### 将素材整理到文件夹中

1. 上传素材文件
2. 检查上传状态
3. 创建文件夹
4. 将项目移动到文件夹

## Notes

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

## Using Canva as an Agent Tool

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

另请参阅：[集成](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.