Google Sheets

Google Sheets是一款基于网络的电子表格应用程序。本模块提供从Google Sheets文档中加载和处理数据的功能，支持多种数据格式选项和表格选择。

此模块提供了一个功能强大的Google表格文档加载器，该加载器能够：

• 从多个电子表格中加载数据

• 选择特定的表格和范围

• 处理格式化值和非格式化值

• 处理公式和计算

• 自定义头部处理

• 使用文本分割工具处理内容

• 处理OAuth2身份验证

输入

必选参数

• 连接凭证：Google Sheets OAuth2 凭证。请参阅 #Google Sheets

• 选择电子表格：从您的Google云端硬盘中选择电子表格

可选参数

• Sheet Names: 以逗号分隔的待加载工作表名称列表

• 范围：要加载的特定范围（例如，A1:E10）

• 包含表头：是否将第一行作为表头（默认值：是）

• 数值渲染选项：数值应如何表示：

  • 格式化值：如用户界面所示

  • 未格式化值：原始值

  • 公式：原始公式

• 文本分割器：用于处理提取内容的文本分割器

• 附加元数据：包含附加元数据的JSON对象

• 省略元数据键：以逗号分隔的需省略的元数据键列表

输出

• Document：包含元数据和页面内容的文档对象数组

• 文本：来自文档的pageContent的拼接字符串

功能

• OAuth2 身份验证

• 支持多种电子表格格式

• 工作表选择

• 范围规范

• 报头处理

• 值格式化选项

• 文本分割支持

• 元数据定制

值渲染选项

格式化值

• 用户界面中显示的值

• 包括格式化

• 带小数的数字/货币

• 指定格式的日期

未格式化值

• 原始单元格值

• 未格式化的数字

• 日期作为序列号

• 布尔值表示为true/false

公式

• 原始公式

• 单元格引用

• 功能

• 计算

文档结构

每份文件包含：

• pageContent：格式化后的表格内容

• 元数据：

  • spreadsheetId：谷歌表格ID

  • spreadsheetName: 文档名称

  • sheetName：工作表名称

  • 范围：选定范围

  • headers: 列标题（若包含）

  • lastModified：最后修改日期

  • url: 网页查看链接

  • 附加自定义元数据

注释

• 需要OAuth2身份验证

• 处理速率限制

• 支持大型电子表格

• 内存高效处理

• 无效范围的错误处理

• 自动刷新令牌

• 实时数据访问