Google Группы (Google Groups)
Группы Google Workspace и участники в процессах Pailot
Google Группы (Google Groups) — списки рассылки и группы Google Workspace (рабочий пакет Google для организаций). Блок ходит в Admin SDK Directory API (Application Programming Interface — программный интерфейс) по OAuth (вход по разрешению сервиса).
С Google Группами в Pailot вы можете:
- Смотреть список групп домена, карточку группы, создавать, обновлять и удалять группу
- Смотреть участников, добавлять, менять роль (MEMBER, MANAGER, OWNER) и удалять
- Проверять, состоит ли пользователь в группе
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Секреты — в переменных окружения рабочего пространства.
Список групп домена Google Workspace.
| Параметр | Тип | Обязательный | Описание |
|---|
customer | string | Нет | ID клиента или my_customer для домена текущего пользователя |
domain | string | Нет | Домен для фильтра групп |
maxResults | number | Нет | Максимум результатов (1–200) |
pageToken | string | Нет | Токен следующей страницы |
query | string | Нет | Поиск групп (например, email:admin*) |
| Параметр | Тип | Описание |
|---|
groups | json | Массив групп |
nextPageToken | string | Токен следующей страницы |
Карточка группы по email или ID.
| Параметр | Тип | Обязательный | Описание |
|---|
groupKey | string | Да | Email группы или уникальный ID |
| Параметр | Тип | Описание |
|---|
group | json | Объект группы |
Создать группу в домене.
| Параметр | Тип | Обязательный | Описание |
|---|
email | string | Да | Email новой группы (например, team@yourdomain.com) |
name | string | Да | Отображаемое имя группы |
description | string | Нет | Описание группы |
| Параметр | Тип | Описание |
|---|
group | json | Созданная группа |
Обновить существующую группу.
| Параметр | Тип | Обязательный | Описание |
|---|
groupKey | string | Да | Email группы или уникальный ID |
name | string | Нет | Новое отображаемое имя |
description | string | Нет | Новое описание |
email | string | Нет | Новый email группы |
| Параметр | Тип | Описание |
|---|
group | json | Обновлённая группа |
Удалить группу.
| Параметр | Тип | Обязательный | Описание |
|---|
groupKey | string | Да | Email или ID группы |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе |
Список участников группы.
| Параметр | Тип | Обязательный | Описание |
|---|
groupKey | string | Да | Email группы или уникальный ID |
maxResults | number | Нет | Максимум результатов (1–200) |
pageToken | string | Нет | Токен следующей страницы |
roles | string | Нет | Фильтр ролей через запятую: OWNER, MANAGER, MEMBER |
| Параметр | Тип | Описание |
|---|
members | json | Массив участников |
nextPageToken | string | Токен следующей страницы |
Карточка участника группы.
| Параметр | Тип | Обязательный | Описание |
|---|
groupKey | string | Да | Email группы или уникальный ID |
memberKey | string | Да | Email участника или уникальный ID |
| Параметр | Тип | Описание |
|---|
member | json | Объект участника |
Добавить участника в группу.
| Параметр | Тип | Обязательный | Описание |
|---|
groupKey | string | Да | Email группы или уникальный ID |
email | string | Да | Email нового участника |
role | string | Нет | Роль: MEMBER, MANAGER или OWNER. По умолчанию MEMBER |
| Параметр | Тип | Описание |
|---|
member | json | Добавленный участник |
Удалить участника из группы.
| Параметр | Тип | Обязательный | Описание |
|---|
groupKey | string | Да | Email группы или уникальный ID |
memberKey | string | Да | Email или ID участника |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе |
Сменить роль участника.
| Параметр | Тип | Обязательный | Описание |
|---|
groupKey | string | Да | Email группы или уникальный ID |
memberKey | string | Да | Email участника или уникальный ID |
role | string | Да | Новая роль: MEMBER, MANAGER или OWNER |
| Параметр | Тип | Описание |
|---|
member | json | Обновлённый участник |
Проверить, состоит ли пользователь в группе.
| Параметр | Тип | Обязательный | Описание |
|---|
groupKey | string | Да | Email группы или уникальный ID |
memberKey | string | Да | Email или ID пользователя |
| Параметр | Тип | Описание |
|---|
isMember | boolean | Пользователь состоит в группе |
