请参阅 Application Integration 支持的连接器

“表格 - 附加”任务

借助表格 - 附加任务,您可以在 Google 电子表格的特定数据表之后附加数据。新值将附加到指定表之后创建的新行,从表的第一列开始。

Google 表格Google Workspace 提供的众多云端高效办公解决方案之一。它可让您通过实时协作功能创建和编辑在线电子表格。

准备工作

在配置表格 - 附加任务之前,请确保在 Google Cloud 项目中执行以下任务:

  1. 启用 Google 表格 API (sheets.googleapis.com)。

    启用 Google 表格 API

  2. 创建身份验证配置文件。Application Integration 使用身份验证配置文件连接到表格 - 附加任务的身份验证端点。

    如需了解如何向服务账号授予其他角色或权限,请参阅授予、更改和撤消访问权限

  3. 了解和了解 Google 表格中使用的常见术语

配置“表格 - 附加”任务

  1. 在 Google Cloud 控制台中,前往 Application Integration 页面。

    转到 Application Integration

  2. 在导航菜单中,点击 Integrations(集成)。

    系统随即会显示集成页面,其中列出了 Google Cloud 项目中提供的所有集成。

  3. 选择现有集成,或点击创建集成以创建新集成。

    要创建新的集成,请执行以下操作:

    1. Create Integration(创建集成)窗格中输入名称和说明。
    2. 选择集成区域。
    3. 为集成选择服务帐号。您随时可以在集成工具栏的 集成摘要窗格中更改或更新集成的服务帐号详细信息。
    4. 点击创建

    系统会在集成编辑器中打开集成。

  4. 集成编辑器导航栏中,点击 Tasks 以查看可用任务列表。
  5. 点击表格 - 附加元素,并将其放置在集成编辑器中。
  6. 点击设计器上的表格 - 附加元素,以查看表格 - 附加任务配置窗格。
  7. 前往身份验证,然后选择您要使用的现有身份验证配置文件。

    可选。如果您在配置此任务之前未创建身份验证配置文件,请点击 + New authentication profile(+ 新建身份验证配置文件),然后按照创建新的身份验证配置文件中所述的步骤操作。

  8. 前往 Task Input(任务输入),然后使用以下任务输入参数表配置显示的输入字段。

    系统会自动保存对输入字段的更改。

任务输入参数

下表介绍了表格 - 附加任务的输入参数:

属性 数据类型 说明
SpreadsheetId 字符串 您的电子表格的 ID。

您可以从电子表格的网址中找到该电子表格的 ID。例如:https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0

范围 字符串 用于在工作表中搜索所需表的范围的 A1 表示法
IncludeValuesInResponse 布尔值 指示返回的对象是否应包含附加值的单元格的值。
InsertDataOption 枚举 (InsertDataOption) 指示在附加新数据时如何更改现有数据。
ValueInputOption 枚举 (ValueInputOption) 指示数据的解读方式。

默认值INPUT_VALUE_OPTION_UNSPECIFIED

ResponseDateTimeRenderOption 枚举 (DateTimeRenderOption) 指示与日期、时间和时长相关的值在输出中的表示方式。

默认值SERIAL_NUMBER

ResponseValueRenderOption 枚举 (ValueRenderOption) 指示输出中如何表示检索的值。

默认值FORMATTED_VALUE

请求 JSON 请求正文是 ValueRange 对象,描述了要写入的范围值。请参阅请求 JSON 结构

任务输出

表格 - 附加任务返回包含 AppendValuesResponse 对象的响应输出,类似于以下示例输出:

    {
        "spreadsheetId": SPREADSHEET_ID,
        "tableRange": "Sheet1!A1:D2",
        "updates": {
          "spreadsheetId": SPREADSHEET_ID,
          "updatedRange": "Sheet1!A3:D4",
          "updatedRows": 2,
          "updatedColumns": 4,
          "updatedCells": 8,
        }
      }

错误处理策略

任务的错误处理策略指定当任务因暂时性错误而失败时要执行的操作。如需了解如何使用错误处理策略,以及了解不同类型的错误处理策略,请参阅错误处理策略

后续步骤

  1. 添加边缘和边缘条件
  2. 测试并发布您的集成。
  3. 配置触发器
  4. 添加数据映射任务
  5. 查看 Google Cloud 服务的所有任务