“表格 - 获取”任务

借助表格 - 获取任务，您可以读取和检索 Google 电子表格中的单个值范围。

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

须知事项

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

启用 Google Sheets API (sheets.googleapis.com)。
启用 Google Sheets API
创建类型为 Service account 的身份验证个人资料。Application Integration 使用身份验证配置文件（服务账号）连接到身份验证端点，以便完成 Google 表格 - 获取任务。
如需了解如何向服务账号授予其他角色或权限，请参阅授予、更改和撤消访问权限。
在 Google 表格中，向服务账号授予访问电子表格的权限。
了解和学习 Google 表格中使用的常用术语。

配置“表格 - 获取”任务

在 Google Cloud 控制台中，前往 Application Integration 页面。
转到 Application Integration
在导航菜单中，点击集成。
系统会显示集成页面，其中列出了 Google Cloud 项目中可用的所有集成。
选择现有集成，或点击创建集成以创建新的集成。
要创建新的集成，请执行以下操作：
1. 在创建集成窗格中输入名称和说明。
2. 选择集成的区域。
  注意：区域下拉列表仅列出您的 Google Cloud 项目中预配的区域。如需预配新区域，请点击 Enable Region。如需了解详情，请参阅启用新区域。
3. 选择用于集成的服务账号。您随时可以在集成工具栏的 集成摘要窗格中更改或更新集成的服务账号详细信息。
  注意：只有当您为所选区域启用了集成治理功能时，系统才会显示用于选择服务账号的选项。
4. 点击创建。
系统随即会在集成编辑器中打开该集成。
在集成编辑器导航栏中，点击任务查看可用任务和连接器的列表。
点击 Google 表格 - 获取元素，并将其放入集成编辑器中。
点击设计器上的 Sheets - Get 元素以查看 Sheets - Get 任务配置窗格。
前往身份验证，然后选择您要使用的现有身份验证配置文件。
可选。如果您在配置此任务之前未创建身份验证配置文件，请点击 + New authentication profile（+ 新建身份验证配置文件），然后按照创建新的身份验证配置文件中所述的步骤操作。
前往 Task Input（任务输入），然后使用以下任务输入参数表配置显示的输入字段。
系统会自动保存对输入字段的更改。

任务输入参数

下表介绍了 Google 表格 - 获取任务的输入参数：

属性	数据类型	说明
SpreadsheetId	字符串	电子表格的 ID。您可以从电子表格的网址中找到其 ID。例如：`https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0`。
MajorDimension	枚举（维度）	应该应用的主要类别或维度。例如 `ROWS` 或 `COLUMNS`。默认值： `DIMENSION_UNSPECIFIED`
范围	字符串	要从中检索值的范围的 A1 表示法或 R1C1 表示法。
dateTimeRenderOption	枚举 (DateTimeRenderOption)	表示输出中如何表示与日期、时间和时长相关的值。注意：如果为 valueRenderOption 指定的值为 `FORMATTED_VALUE`，则不考虑 dateTimeRenderOption。默认值： `SERIAL_NUMBER`
ValueRenderOption	枚举 (ValueRenderOption)	指示输出中如何表示检索的值。默认值： `FORMATTED_VALUE`

任务输出

表格 - 获取任务返回包含与请求的范围相对应的 ValueRange 对象的响应输出。以下是输出示例：

    {
        "range": "Sheet1!A1:D5",
        "majorDimension": "ROWS",
        "values": [
          ["Item", "Cost", "Stocked", "Ship Date"],
          ["Wheel", "$20.50", "4", "42430"],
          ["Door", "$15", "2", "42444"],
          ["Engine", "$100", "1", "42449"],
          ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
        ],
      }

错误处理策略

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

配额和限制

如需了解配额和限制，请参阅配额和限制。