谷歌工作表连接器

谷歌工作表连接器

简介

谷歌工作表 API 允许用户通过对其谷歌账户设置正确的访问权限来创建、读取和编辑谷歌工作表。该连接器的目标是利用 Tulip 的 Oauth 2.0，使用 HTTP连接器与 Google Sheets 集成，并为客户提供一个可导入其实例的开箱即用连接器。

目的

1. 我们将重点介绍不同的 HTTP 连接器功能，这些功能可以通过 HTTP 调用 Google Sheets API(v4) 端点来与 Google 电子表格进行交互，以尝试电子表格上的各种读写操作，这些操作可用于各种用例。

API 文档

1. 谷歌工作表 API 参考文档

前提条件

1. 在 Google 云控制台创建账户并配置 OAuth 2.0 认证。更多信息请参阅 Google 的 API 文档。
2. 在谷歌云控制台添加实例重定向 URL

郁金香连接详细信息

需要在 Tulip 连接器上配置以下信息。

1. 运行于：云连接器主机
2. 主机：sheet.googleapis.com
3. 端口：443
4. TLS: 是
5. OAuth 2（管理）：身份验证将转发至所有连接器功能

连接器功能

谷歌新电子表格

用途

1. 用户可将电子表格名称和工作表名称作为输入，Tulip 将根据提供的工作表名称创建新的电子表格。API 的响应将是电子表格的元数据和各种属性，可进一步用作过滤器，从电子表格中获取和更新数据。
2. 从谷歌电子表格 V4 API 提取的信息可进一步用于 Tulip 应用程序、Tulip 表格或 Tulip 变量，这些变量将被输送到其他连接器功能中。

端点

HTTP POST 调用端点**https://sheets.googleapis.com/v4/spreadsheets**

所需输入

以下是作为请求体发送的参数

1. 电子表格名称 - 电子表格标题
2. 工作表名称 - 初始工作表标题

输出提取器

1. 电子表格：电子表格的唯一标识符，用于执行其他任务
2. 电子表格 URL：新创建电子表格的 URL

谷歌获取电子表格数据

用途

此连接器将从提供的电子表格 ID 中获取指定范围内的数据。数据将根据提供给连接器函数的查询参数，以行或列数组的形式提供

端点

HTTP GET 调用端点-https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

所需输入

以下是需要传递的 URL 参数

1. 电子表格 ID
2. Range - A1 格式 的字符串。

a1_notation)

连接器函数将提供的其他查询参数包括

1. majorDimension ：ROWS 或 COLUMNS 决定内部数据数组的大小
2. dateTimeRenderOption 指定日期时间字段的格式 默认值：FORMATTED_STRING
3. valueRenderOption 指定数据在响应中是格式化还是未格式化，默认值：formatted_value：格式化值

输出提取器

1. 值：这是一个数组的数组，每一行数据都是一个数组。

谷歌电子表格插入行

用途

向电子表格中添加数值。输入范围用于搜索现有数据，并在该范围内查找 "表格"。数值将从表格的第一列开始，追加到表格的下一行。连接器将接收电子表格 ID、范围和要插入单元格的值列表。

端点

HTTP POST 调用端点 -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

所需输入

以下是需要传递的查询参数

1. 电子表格 ID
2. 范围
3. 值：对于此连接器，我们考虑了 8 个列的值，每个参数都根据要插入的列命名。这将以数组的形式传递给应用程序接口。

连接器函数将提供的其他查询参数有

1. 值输入选项（valueInputOption）：这是一个必填字段，将由连接器发送，默认值设置为USER_ENTERED

输出提取器

1. 电子表格 ID
2. UpdatedRows（更新行数）：指定插入的行数

清除谷歌电子表格

用途

清除电子表格中的值。调用者必须指定电子表格 ID 和范围。只清除数值--保留单元格的所有其他属性（如格式化、数据验证等）。连接器将接收电子表格 ID、范围和要插入单元格的值列表。

端点

HTTP POST 调用端点 -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear

所需输入

以下是需要传递的查询参数

1. 电子表格 ID
2. 范围

Google 通过筛选器获取电子表格详细信息

用途

该连接器将根据提供的电子表格 ID 和数据过滤器中指定的特定条件获取电子表格详细信息。

端点

HTTP POST 调用端点 -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getbyDataFilter

所需输入

以下是需要传递的查询参数

1. 电子表格 ID
2. includeGridData：默认值为假

以下参数将以 JSON 格式作为请求正文的一部分发送

1. 网格范围

输出提取器

1. 电子表格 ID
2. 标题
3. 地域
4. 自动重新计算
5. 时区
6. 工作表编号
7. 工作表标题
8. 工作表类型
9. 工作表行数
10. 工作表列数
11. 电子表格链接

根据用户使用情况，输出中还可以包含其他参数

谷歌批量获取数据

用途

该连接器将从提供的电子表格 ID 中获取数据。 数据将根据提供给连接器的查询参数，以行或列数组的形式提供。

端点

HTTP GET 调用端点-https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

所需输入

以下是需要传递的查询参数

1. 电子表格 Id
2. Range - A1Format 中的字符串。

a1_notation)

连接器函数将提供的其他查询参数包括

1. majorDimension ：ROWS 或 COLUMNS 决定内部数据数组的大小
2. dateTimeRenderOption 指定日期时间字段的格式 默认值：FORMATTED_STRING
3. valueRenderOption 指定数据在响应中是格式化还是未格式化 默认值：FORMATTED_VALUE

输出提取器

1. valueRanges（值范围）：这是一个对象数组。每个对象详细说明一个范围

谷歌批量获取数据过滤器

用途

该连接器将以批量数据的形式从给定过滤条件中提供的电子表格 ID 中获取数据。根据提供给连接器的查询参数，数据将以行或列数组的形式提供

端点

HTTP POST 调用端点-https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter

所需输入

以下是需要传递的查询参数

1. 电子表格 Id

连接器函数将提供的其他请求正文参数包括

1. 数据过滤器
2. majorDimension ：ROWS 或 COLUMNS 决定内部数据数组的大小
3. dateTimeRenderOption 指定日期时间字段的格式 默认值：FORMATTED_STRING
4. valueRenderOption 指定数据在响应中是格式化还是未格式化，默认值：formatted_value：格式化值

输出提取器

1. valueRanges（值范围）：这是一个对象数组。每个对象详细说明一个范围

视频