“表格 - 附加”任务

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

Google 表格是 Google Workspace 中众多云端高效办公解决方案之一。它可以帮助您通过实时协作功能创建和修改在线电子表格。

须知事项

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

启用 Google Sheets API (sheets.googleapis.com)。
启用 Google Sheets API
创建身份验证配置文件。Apigee Integration 使用身份验证配置文件连接到表格 - 附加任务的身份验证端点。
如需了解如何向服务账号授予其他角色或权限，请参阅授予、更改和撤消访问权限。
了解 Google 表格中的常见术语。

配置“表格 - 附加”任务

在 Apigee 界面中，选择您的 Apigee 组织。
点击开发 > 集成。
选择现有集成，或通过点击创建集成来创建新集成。
要创建新的集成，请执行以下操作：
1. 在创建 Integrations对话框中输入名称和说明。
2. 从支持的区域列表中选择集成的区域。
3. 点击创建。
这将在集成设计器中打开集成。
在集成设计器导航栏中，点击 + 添加任务/触发器 > 任务以查看可用任务列表。
点击表格 - 附加元素，并将其放置到集成设计器中。
点击设计器上的表格 - 附加元素以查看表格 - 附加任务配置窗格。
前往身份验证，然后选择您要使用的现有身份验证配置文件。
可选。如果您在配置此任务之前未创建身份验证配置文件，请点击 + New authentication profile（+ 新建身份验证配置文件），然后按照创建新的身份验证配置文件中所述的步骤操作。
前往 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)	指示在输出中如何表示与日期、时间和时长相关的值。注意：如果为 valueRenderOption 指定的值为 `FORMATTED_VALUE`，则不考虑 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,
        }
      }

错误处理策略

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