Google表格
连接到 Google Sheets 以管理电子表格。 可以在电子表格上与他人创建、编辑和协作。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 标准 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 标准 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 标准 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps 支持 Microsoft Power Automate 支持 Microsoft Power Apps 支持 |
| 连接器元数据 | |
|---|---|
| 发布者 | Microsoft |
| 网站 | https://www.google.com/sheets/about/ |
| 隐私策略 | https://policies.google.com/privacy |
已知问题和限制
- 不支持其他流运行的同时文件修改、并行 foreach 执行和手动编辑。
- 共享电子表格不通过 Power Automate/逻辑应用中的文件选取器 UI 组件可见。 作为一种解决方法，可以提供共享电子表格 ID 作为自定义值输入。 此 ID 是电子表格 URL 中“/d/”和“/edit”之间的值。 例如，请考虑引用 Google Sheets 电子表格的以下 URL：
https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0 - 无法在任何平台中选择位于共享驱动器中的电子表格。 对于 Power Automate/逻辑应用，可以使用上一步中提到的解决方法。
列名处理
请注意，作响应结果中的列名称可能会转换，以便与 OData 格式兼容：
| 字符 | 编码值 |
|---|---|
| . | _x002e_ |
| @ | _x0040_ |
| : | _x003a_ |
| + | _x002b_ |
| # | _x0023_ |
| / | _x002f_ |
| ? | _x003f_ |
| % | _x0025_ |
| & | _x0026_ |
| ' ' | _x0020_ |
| ~ | _x007e_ |
| ` | _x0060_ |
例如 Column [one]#1 ->Column_x0020_[one]_x0023_1
将排除在列名末尾（仅）括在括号中的字符，请参阅示例： Column [group]>Column
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 300 秒 |
操作
| 删除行 |
此作用于从 Google Sheet 检索行。 |
| 插入行 |
此作用于在 Google Sheet 中插入新行。 |
| 更新行 |
此作更新 Google Sheet 中的行。 |
| 获取工作表 |
从 Google Sheet 文件中检索工作表名称 |
| 获取行 |
此作从特定 Google Sheet 中检索记录。 |
| 获取行 |
此作从 Google Sheet 检索单个行。 |
删除行
此作用于从 Google Sheet 检索行。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
dataset | True | string |
选取文件。 |
|
工作表
|
table | True | string |
选取工作表。 |
|
行 ID
|
id | True | string |
要删除的行的唯一标识符。 |
插入行
此作用于在 Google Sheet 中插入新行。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
dataset | True | string |
选取文件。 |
|
工作表
|
table | True | string |
选取工作表。 |
|
行
|
item | True | dynamic |
要插入到指定工作表中的行。 |
返回
此操作输出是动态内容。
更新行
此作更新 Google Sheet 中的行。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
dataset | True | string |
选取文件。 |
|
工作表
|
table | True | string |
选取工作表。 |
|
行 ID
|
id | True | string |
要更新的行的唯一标识符。 |
|
行
|
item | True | dynamic |
具有更新值的行。 |
返回
此操作输出是动态内容。
获取工作表
从 Google Sheet 文件中检索工作表名称
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
dataset | True | string |
指定文件 |
返回
一个或多个表的列表。
- 表列表
- TablesList
获取行
此作从特定 Google Sheet 中检索记录。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
dataset | True | string |
选取文件。 |
|
工作表
|
table | True | string |
选取工作表。 |
|
Top Count
|
$top | integer |
要检索的条目总数（默认值 = 256）。 |
|
|
跳过计数
|
$skip | integer |
要跳过的条目数（默认值 = 0）。 |
返回
此操作输出是动态内容。
获取行
此作从 Google Sheet 检索单个行。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件
|
dataset | True | string |
选取文件。 |
|
工作表
|
table | True | string |
选取工作表。 |
|
行 ID
|
id | True | string |
要检索的行的唯一标识符。 |
返回
此操作输出是动态内容。
定义
TablesList
一个或多个表的列表。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
value
|
value | array of Table |
Table
特定表的属性。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
Name
|
Name | string |
表的摘要。 |
|
显示名称
|
DisplayName | string |
表的显示名称。 |