Когда вы создаете и запускаете автоматизированные процессы в Google Workspace Studio, безопасность и конфиденциальность данных обеспечиваются по умолчанию. В Workspace Studio используется модель идентификации с минимальными привилегиями. Это означает, что автоматизированные процессы выполняют фоновые задачи, используя только минимальные разрешения, необходимые для выполнения каждого отдельного действия, вместо того чтобы иметь широкий неограниченный доступ ко всему аккаунту Google пользователя.
Чтобы безопасно настроить автоматизацию и отслеживать доступ к данным организации, используйте это руководство, чтобы определить разрешения, необходимые для каждого этапа процесса. На этой странице приведена таблица, в которой указаны типы шагов и необходимые для них области действия OAuth.
Как области действия OAuth влияют на использование Studio
При использовании Workspace Studio области действия OAuth влияют на создание, запуск и управление процессами следующим образом:
- Однократная авторизация. Когда вы впервые добавляете шаг, взаимодействующий с сервисом Google (например, Gmail или Google Диском), появляется уведомление для входа в аккаунт Google. Это авторизует определенную область для этого шага, чтобы поток мог выполняться независимо в фоновом режиме.
- Асинхронное выполнение в фоновом режиме. После включения поток выполняется асинхронно в инфраструктуре Google. Поток выполняет задачи (например, создает мероприятие в Календаре или черновик письма), используя только те области доступа, которые вы одобрили, даже если вы не вошли в аккаунт.
- Централизованный контроль администратора. Администратор может просматривать все активные процессы в организации, используя настройки Управления доступом агентов в консоли администратора. Вы можете приостановить определенные потоки или настроить таргетинг и ограничить отдельные области действия OAuth (например, отключить доступ к Диску, оставив Gmail активным), чтобы защитить данные организации. Подробнее…
Как устранить неполадки с разрешениями
Если поток не выполняется и в журнале действий появляется сообщение об ошибке "Недостаточно разрешений" или "Что-то пошло не так", проверьте следующее:
- Повторно авторизуйте рабочий процесс. Откройте рабочий процесс в конструкторе, нажмите Сохранить изменения и следуйте инструкциям в окне авторизации, чтобы обновить просроченные или отсутствующие токены OAuth.
- Блокировка контекстно-зависимого доступа. Если в вашей организации действуют строгие правила для устройств или IP-адресов, выполнение фоновых процессов может быть заблокировано. Убедитесь, что основной идентификатор клиента Workspace Studio не подпадает под ограничения CAA.
Шаги процесса и необходимые области действия OAuth
В таблице ниже перечислены стандартные шаги Workspace Studio и области действия OAuth, необходимые для их выполнения в фоновом режиме.
| Название этапа | Настройка и область применения |
|---|---|
| Действия с ИИ в Studio | |
| Примитивы AIP (Ask Gemini, Ask a Gem, Create with Gemini, Deep Research, Recap unread emails, Extract, Decide, Summarize) | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/cloud_search.query |
| Общие и служебные | |
| По расписанию | – |
| Отправить вебхук | Н/Д – сторонний внешний |
| Проверьте, | Н/Д – внутренняя логика |
| Как отфильтровать список | Н/Д – внутренняя логика |
| Gmail | |
| Когда я получаю письмо | https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.event_trigger https://www.googleapis.com/auth/workspace.workflows.trigger |
| Уведомления по электронной почте | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly |
| Как отправить письмо | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| Как создать черновик письма | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly |
| Как переслать письмо | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| Написать черновик ответа | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| Как ответить на письмо | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| Как добавить или удалить ярлыки | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| Как отметить письмо как прочитанное или непрочитанное | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| Пометить или снять пометку | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| Архивирование или удаление | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| Google Chat | |
| Когда кто-то присоединяется к чат-группе | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| Когда я получаю сообщение в чате | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| Когда меня упоминают | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| Когда добавлена реакция с эмодзи | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| Уведомить меня в Chat | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships |
| Отправить чат-группу | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces |
| Отправить другим пользователям | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships |
| Как ответить на сообщение | https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships |
| Google Таблицы | |
| При изменении листа | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly |
| Как добавить строку | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Обновить строки | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Очистить строки | https://www.googleapis.com/auth/spreadsheet https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Получить содержимое листа | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Google Документы | |
| Как создать документ Google | https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly |
| Как добавить в документ | https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly |
| Google Календарь и Задачи | |
| По итогам встречи | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/calendar.events.readonly |
| Как создать задачу | https://www.googleapis.com/auth/tasks |
| Создание мероприятия | https://www.googleapis.com/auth/calendar.events |
| Как добавить гостей | https://www.googleapis.com/auth/calendar.events |
| Google Диск | |
| Когда объект добавлен в папку | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly |
| Когда редактируется файл | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Когда редактируется объект в папке | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly |
| Переместить файл | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| Копирование файла | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| Как сохранять прикрепленные файлы | https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| Как создать папку | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| Google Meet | |
| Когда используются заметки к встрече | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.meet.readonly https://www.googleapis.com/auth/meetings.space.created https://www.googleapis.com/auth/calendar.events.readonly https://www.googleapis.com/auth/meetings.space.readonly |
| Google Формы | |
| Когда поступает ответ на форму | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/forms.responses.readonly https://www.googleapis.com/auth/forms.body.readonly https://www.googleapis.com/auth/drive.readonly (только для поддержки файлов DLP в Формах) |
| NotebookLM | |
| Как добавить источник в NotebookLM | https://www.googleapis.com/auth/drive.readonly |
| Спросить у NotebookLM | https://www.googleapis.com/auth/drive.readonly |