mirror of
https://github.com/simstudioai/sim.git
synced 2026-02-12 07:24:55 -05:00
220 lines
5.8 KiB
Plaintext
220 lines
5.8 KiB
Plaintext
---
|
||
title: Google 群组
|
||
description: 管理 Google Workspace 群组及其成员
|
||
---
|
||
|
||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||
|
||
<BlockInfoCard
|
||
type="google_groups"
|
||
color="#E8F0FE"
|
||
/>
|
||
|
||
## 使用说明
|
||
|
||
连接到 Google Workspace，使用 Admin SDK Directory API 创建、更新和管理群组及其成员。
|
||
|
||
## 工具
|
||
|
||
### `google_groups_list_groups`
|
||
|
||
列出 Google Workspace 域中的所有群组
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `customer` | string | 否 | 客户 ID 或 "my_customer" 表示已认证用户的域 |
|
||
| `domain` | string | 否 | 用于筛选群组的域名 |
|
||
| `maxResults` | number | 否 | 返回的最大结果数 \(1-200\) |
|
||
| `pageToken` | string | 否 | 分页的令牌 |
|
||
| `query` | string | 否 | 用于筛选群组的搜索查询 \(例如："email:admin*"\) |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `groups` | json | 群组对象的数组 |
|
||
| `nextPageToken` | string | 用于获取下一页结果的令牌 |
|
||
|
||
### `google_groups_get_group`
|
||
|
||
通过电子邮件或群组 ID 获取特定 Google 群组的详细信息
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `groupKey` | string | 是 | 群组电子邮件地址或唯一群组 ID |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `group` | json | 群组对象 |
|
||
|
||
### `google_groups_create_group`
|
||
|
||
在域中创建一个新的 Google 群组
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `email` | string | 是 | 新组的电子邮件地址 \(例如：team@yourdomain.com\) |
|
||
| `name` | string | 是 | 组的显示名称 |
|
||
| `description` | string | 否 | 组的描述 |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `group` | json | 创建的群组对象 |
|
||
|
||
### `google_groups_update_group`
|
||
|
||
更新现有的 Google 群组
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `groupKey` | string | 是 | 群组的电子邮件地址或唯一群组 ID |
|
||
| `name` | string | 否 | 群组的新显示名称 |
|
||
| `description` | string | 否 | 群组的新描述 |
|
||
| `email` | string | 否 | 群组的新电子邮件地址 |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `group` | json | 更新的群组对象 |
|
||
|
||
### `google_groups_delete_group`
|
||
|
||
删除 Google 群组
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `groupKey` | string | 是 | 要删除的群组电子邮件地址或唯一群组 ID |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `message` | string | 成功消息 |
|
||
|
||
### `google_groups_list_members`
|
||
|
||
列出 Google 群组的所有成员
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `groupKey` | string | 是 | 群组的电子邮件地址或唯一群组 ID |
|
||
| `maxResults` | number | 否 | 返回的最大结果数 \(1-200\) |
|
||
| `pageToken` | string | 否 | 分页的令牌 |
|
||
| `roles` | string | 否 | 按角色筛选 \(逗号分隔：OWNER, MANAGER, MEMBER\) |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `members` | json | 成员对象的数组 |
|
||
| `nextPageToken` | string | 用于获取下一页结果的令牌 |
|
||
|
||
### `google_groups_get_member`
|
||
|
||
获取 Google 群组中特定成员的详细信息
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `groupKey` | string | 是 | 群组的电子邮件地址或唯一群组 ID |
|
||
| `memberKey` | string | 是 | 成员的电子邮件地址或唯一成员 ID |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `member` | json | 成员对象 |
|
||
|
||
### `google_groups_add_member`
|
||
|
||
向 Google 群组添加新成员
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `groupKey` | string | 是 | 群组的电子邮件地址或唯一群组 ID |
|
||
| `email` | string | 是 | 要添加成员的电子邮件地址 |
|
||
| `role` | string | 否 | 成员的角色 \(MEMBER, MANAGER, 或 OWNER\)。默认为 MEMBER。 |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `member` | json | 添加的成员对象 |
|
||
|
||
### `google_groups_remove_member`
|
||
|
||
从 Google 群组中移除成员
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `groupKey` | string | 是 | 群组的电子邮件地址或唯一群组 ID |
|
||
| `memberKey` | string | 是 | 要移除的成员的电子邮件地址或唯一 ID |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `message` | string | 成功消息 |
|
||
|
||
### `google_groups_update_member`
|
||
|
||
更新成员信息
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `groupKey` | string | 是 | 群组的电子邮件地址或唯一群组 ID |
|
||
| `memberKey` | string | 是 | 成员的电子邮件地址或唯一成员 ID |
|
||
| `role` | string | 是 | 成员的新角色 \(MEMBER, MANAGER, 或 OWNER\) |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `member` | json | 更新的成员对象 |
|
||
|
||
### `google_groups_has_member`
|
||
|
||
检查用户是否为 Google 群组的成员
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `groupKey` | string | 是 | 群组的电子邮件地址或唯一群组 ID |
|
||
| `memberKey` | string | 是 | 要检查的成员的电子邮件地址或唯一成员 ID |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `isMember` | boolean | 用户是否是该群组的成员 |
|
||
|
||
## 注意事项
|
||
|
||
- 类别：`tools`
|
||
- 类型：`google_groups`
|