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

> 配置工作流步骤，通过已连接账户查询 GA4 报告和属性元数据

当你希望工作流步骤从已连接账户获取 GA4 属性元数据、验证维度/指标组合或列出账户和属性时，请使用 **Google Analytics**。

## 配置

| 选项    | 必填 | 说明                                                                                          |
| ----- | -- | ------------------------------------------------------------------------------------------- |
| 名称    | 否  | 工作流画布中该步骤的标签。                                                                               |
| 身份验证  | 是  | 此步骤使用的已连接 Google Analytics 账户。                                                              |
| 操作    | 是  | 要执行的 Analytics 操作（例如 Get Metadata、Check Compatibility、List Account Summaries）。              |
| 参数    | 是  | 根据操作 schema 自动生成的表单字段。每个文本字段都有 **插入变量** 按钮，可注入 `{{placeholder}}` 值。高级用户可使用 **原始 JSON** 选项卡。 |
| 步骤失败时 | 否  | 控制此步骤失败时工作流应 **终止工作流** 还是 **继续**。                                                           |

配置此步骤前，请在工作区的 **集成** 中通过 OAuth 流程连接 Google Analytics。如果没有可用连接，步骤会显示警告并提供 **集成** 链接，而不是账户选择器。

## 可用操作

工作流操作选择器显示一组精选的只读操作：

| 操作                     | 说明               |
| ---------------------- | ---------------- |
| Get Metadata           | 发现某个属性的有效维度和指标。  |
| Check Compatibility    | 在运行报告前验证维度和指标组合。 |
| List Account Summaries | 列出账户及子属性。        |
| List Property          | 列出符合筛选表达式的属性。    |
| Get Property           | 获取单个属性的详细信息。     |

报告类操作（Run Report、Run Realtime Report 和 Batch Run Reports）目前不会出现在工作流操作选择器中。

写入和管理类操作不会出现在工作流操作选择器中。

## 备注

* 此步骤依赖工作区中已连接的 Google Analytics 集成。
* 构建复杂报告时，请使用 **Get Metadata** 或 **Check Compatibility** 以避免无效组合。
* OAuth 连接流程中可能显示第三方授权品牌信息。

## 将 Google Analytics 用作智能体工具

你也可以在 **智能体编辑器** 中将 Google Analytics 添加为工具。打开智能体，点击 **添加工具**，然后选择 **Google Analytics**。

另请参阅：[集成](../../../workspace/integrations)、[创建与编辑](../../creating-and-editing) 和 [测试与迭代](../../testing-and-iteration)