Automa谷歌表格模块

在自动化任务中，能够从谷歌表格（Google Sheets）读取或写入数据是非常有用的功能。谷歌表格模块 提供了强大的工具，帮助你在自动化工作流中与谷歌表格进行交互。通过该模块，你可以获取表格中的数据，或将新数据写入指定的单元格，还支持共享表格权限以及自定义数据源。

1. 访问表格权限设置

在使用此模块之前，你需要为 Automa 提供访问谷歌表格的权限。权限设置有两种方式：

• 公开表格：将表格设置为公开访问，Automa 只能获取表格的读取权限。

• 共享表格与服务账户：如果你需要写入或更新表格数据，你必须将表格与 Automa 的服务账户共享。操作步骤如下：

  1. 打开谷歌表格，点击右上角的“共享”按钮。
  2. 输入 service@automa2.iam.gserviceaccount.com 并将其设置为编辑权限。

2. 表格ID

表格ID 是你在谷歌表格URL中找到的独特标识符。它由字母、数字、连字符和下划线组成。每个谷歌表格的ID都是唯一的，确保你与正确的表格进行交互。

示例：

    
plaintext复制
    
https://docs.google.com/spreadsheets/d/10FGdgjWhkFeJ8m-M5WC0zDIMnSqRFuctuZ1CkOr38mY/edit

    

在此URL中，10FGdgjWhkFeJ8m-M5WC0zDIMnSqRFuctuZ1CkOr38mY 就是表格的ID。

3. 范围（Range）

在读取或写入谷歌表格数据时，范围 决定了你想要获取或更新的单元格。你可以通过以下两种表示法来定义范围：

• A1表示法：如 Sheet1!A1:B2，表示Sheet1工作表的A1到B2单元格范围。
• R1C1表示法：如 Sheet1!R1C1:R2C2，使用行列表示法定义范围。

4. 获取表格值

获取表格值 功能允许你从谷歌表格的指定范围中提取数据。你可以选择使用表格的第一行作为键来构造返回的数据对象，这使得数据更具可读性。

示例：

假设你的表格如下所示：

| name | age |
| ---- | ---- |
| foo | 22 |
| bar | 23 |

• 如果你启用了使用第一行作为键，返回的数据格式会是：

    
json复制
    
[{ "name": "foo", "age": 22 }, { "name": "bar", "age": 23 }]

    

• 如果未启用，数据将以二维数组的形式返回：

    
json复制
    
[["name", "age"], ["foo", 22], ["bar", 23]]

    

5. 更新表格值

除了读取数据，你还可以使用 更新表格值 功能将数据写入谷歌表格中的指定范围。你可以选择输入的值是 RAW 格式（不做任何解析），还是 USER_ENTERED 格式（根据谷歌表格用户界面进行解析，可能会将字符串转为数字或日期）。

示例：

    
json复制
    
[["name", "age"], ["John", 25], ["Jane", 28]]

    

这会将 John 和 Jane 的数据写入到表格中。

6. 数据来源

在更新表格时，数据的来源可以是：

• table：使用工作流中的表格数据进行写入操作。
• 自定义：输入自定义JSON格式的数据进行写入。数据必须是数组中的数组格式。

7. 值输入选项

• RAW：将用户输入的数据按原样存储，不做任何解析。
• USER_ENTERED：输入的数据会按照谷歌表格的默认规则进行解析，例如数字、日期等会被自动识别和格式化。

8. 将键作为第一行

在读取或写入表格时，选择将键作为第一行，可以确保第一行被视为表头，从而简化数据的组织和管理。

如何使用谷歌表格模块

假设你正在创建一个工作流，目标是读取并更新谷歌表格中的数据。

1. 获取表格数据：你希望从 Sheet1!A1:B5 读取前五行的数据，并使用第一行作为键来返回一个对象。
2. 更新表格数据：接着，你要将新用户的数据更新到 Sheet1!A6:B7，例如：

    
json复制
    
[["Jane", 30], ["Mike", 27]]

    

3. 表格ID：设置为 10FGdgjWhkFeJ8m-M5WC0zDIMnSqRFuctuZ1CkOr38mY。
4. 共享权限：确保表格已经与 Automa 服务账户共享，以便能够写入数据。

典型应用场景

数据收集和分析：可以自动从表格中提取数据，进行批量分析或操作，再将结果写回表格。

自动化报告生成：通过将数据从多个来源汇总到谷歌表格，生成自动化报告，节省手动操作的时间。

用户信息管理：将用户数据读取到表格中进行批量管理或更新，方便处理大量用户数据。

谷歌表格模块 是自动化任务中的一项强大工具，特别适合需要与谷歌表格进行大量交互的场景。无论是从表格中读取数据，还是将处理后的数据更新到表格，它都能高效地完成任务。结合表格的共享权限和灵活的数据读取、写入设置，你可以轻松实现数据的自动化处理，极大地提升工作效率。如果你经常使用谷歌表格进行数据管理，这个模块绝对值得尝试！

想了解如何利用RPA+AI打造图文工厂 扫描下方二维码加入星球