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

> 通过已连接的账户监控并排查你的网站在 Google 搜索结果中的展示情况。

# Google Search Console

当你需要查看网站在 Google 搜索结果中的展示方式，或者管理其 Search Console 设置时，请使用此应用。你可以检查 URL、查看分析数据，并处理站点地图。

## 配置

| 选项 | 必填 | 说明 |
| - | - | - |
| 名称 | 否 | 工作流画布中此步骤的标签。 |
| 身份验证 | 是 | 此步骤要使用的已连接 Google Search Console 账户。 |
| 操作 | 是 | 要执行的 Google Search Console 操作（例如 Get Site、Get Sitemap、Inspect URL、Search Analytics Query）。 |
| 参数 | 是 | 由操作的 schema 生成的各操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于注入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| 当步骤失败时 | 否 | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |

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

## 参数表单

当你选择某个操作时，**Arguments** 部分会呈现一个由该操作输入 schema 驱动的表单。

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

## 常见操作

| 操作 | 说明 |
| - | - |
| **Get Site** | 获取特定 Search Console 网站的信息。 |
| **Get Sitemap** | 获取 Search Console 中特定站点地图的站点地图元数据。 |
| **Inspect URL** | 检查某个 URL 在 Google Search Console 中的索引问题和状态。 |
| **Search Analytics Query** | 查询 Google Search Console 的搜索分析数据，包括点击、展示次数、CTR 和排名指标。 |
| **List Sitemaps** | 列出 Google Search Console 中某个网站的所有站点地图。 |
| **List Sites** | 列出经过身份验证的用户在 Google Search Console 中拥有的所有已验证网站。 |
| **Submit Sitemap** | 向 Google Search Console 提交站点地图以进行索引。 |

诸如删除记录之类的破坏性操作，在工作流操作选择器中不可用。

## 输出

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

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

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

## 示例

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

## 使用场景

### 检查页面索引状态

1. List Sites
2. Inspect URL
3. Get Site

### 查看搜索表现

1. List Sites
2. Search Analytics Query

### 处理站点地图更新

1. List Sites
2. List Sitemaps
3. Submit Sitemap

## 注意事项

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

## 将 Google Search Console 作为代理工具使用

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

另请参阅：[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.