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

> 配置一个搜索 Google 并存储结果供后续步骤使用的工作流步骤

# Google Search

当你希望工作流步骤从 Fetch Hive 搜索网络并将结果传入后续工作流步骤时,请使用 **Google Search**。

## 配置

| 选项 | 是否必填 | 说明 |
| - | - | - |
| Name | 否 | 步骤在工作流画布中的标签。 |
| Search Query | 是 | **Search Query** 中的查询。此字段通过 **Insert Variable** 支持工作流变量。 |
| Number of Results | 否 | **Number of results** 中的结果数量。 |
| Language | 否 | **Language** 中的语言值。你可以从列表中选择或启用 **Custom Value**。 |
| Language Custom Value | 否 | 控制 **Language** 使用内置列表还是自定义值。 |
| Location | 否 | **Location** 中的位置值。你可以从列表中选择或启用 **Custom Value**。 |
| Location Custom Value | 否 | 控制 **Location** 使用内置列表还是自定义值。 |
| Fallback Search | 否 | 如果主搜索失败,启用 **Fallback Search**。 |
| When the step fails | 否 | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |
| 从 **Search steps...** 的 **Research** 分组添加此步骤。 | | |

**Search Query** 字段支持 **Insert Variable**。**Language** 和 **Location** 控件可以使用内置列表,或者当你想手动输入值或插入工作流变量时切换到 **Custom Value**。

如需以编程方式查看支持的国家/地区,请使用 [Search Service Countries](https://docs.fetchhive.com/zh/api-reference/overview.md)。Google Search 使用国家名称值,例如 `United States`。

## 输出

点击步骤标题中的 **Run** 来测试步骤。运行完成后,Fetch Hive 会在 **Output** 中显示搜索结果输出。

在后续步骤中使用变量选择器插入该次运行可用的确切输出路径。基础引用为:

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

如果你想要完整的结果集,直接引用基础输出:

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

输出是搜索结果列表。每条结果包括 `title`、`link`（页面 URL）、`snippet`、`position`、`domain` 和 `breadcrumb`。没有 `items` 包装层，也没有 `url` 字段。

要抓取或打开第一条结果:

```text theme={null}
{{step_2.output.0.link}}
```

要将每条结果的 URL 传给后续步骤:

```text theme={null}
{{step_2.output.*.link}}
```

如果 Iteration 步骤遍历搜索结果，将迭代源设为 `{{step_2.output}}`，并用 `{{step_3.item.link}}` 读取当前页面 URL（使用 Iteration 步骤自己的标识符）。

在测试运行后使用变量选择器检查返回的搜索结果中可用的任何嵌套字段。

## 示例

从 **Search steps...** 的 **Research** 分组中添加 **Google Search**。

将 **Name** 设置为类似 `Find competitor pricing` 的内容。

在 **Search Query** 中输入你的查询。如果查询的一部分来自早前步骤,点击 **Insert Variable** 并添加该引用。

选择 **Number of results**,然后从列表中设置 **Language** 和 **Location**,或者将任一字段切换为 **Custom Value**。

如果你希望主搜索失败时有备用服务,请启用 **Fallback Search**。

点击 **Run** 并在 **Output** 中查看返回的搜索结果,然后再将结果接入后续步骤。

## 备注

* **Language** 和 **Location** 可以使用内置的可选值或手动的自定义值。
* 当搜索参数应来自早前的工作流步骤时,在 **Search Query** 或自定义语言和位置字段中使用 **Insert Variable**。
* 如果你需要确认后续步骤引用的确切返回字段,运行该步骤一次并检查变量选择器。

另见:[创建和编辑](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md)、[测试与迭代](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md) 和 [错误处理](https://docs.fetchhive.com/zh/workflows/error-handling.md)


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