Когда вы создаете и запускаете автоматизированные процессы в 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 ("Спросить Gemini", "Спросить Gem-бота", "Создать с помощью Gemini", Deep Research, "Пересказ непрочитанных писем", "Извлечь", "Решить", "Краткий пересказ") | 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 |