Пользователи Google Workspace могут автоматизировать задачи в разных сервисах, объединяя последовательность шагов без написания кода. Расширяя потоки, вы позволяете пользователям запускать рабочие процессы на основе событий в приложении и добавлять функции приложения в качестве шагов.
Например, пользователи могут сортировать и назначать входящие вопросы клиентов с помощью процесса, который выполняет следующие действия:
- Получает электронное письмо от клиента.
- Gemini сортирует письма по запросу.
- Создает задачу, чтобы связаться с отделом продаж или службой поддержки.
В этой документации объясняется, как расширить функциональность Google Workspace Studio, создав собственные триггеры и шаги, которые могут выполнять потоки.
Для начала ознакомьтесь с кратким руководством, практическими работами и руководствами для разработчиков в разделе Начало работы.
Основные понятия Workspace Studio
Ниже описаны основные компоненты Workspace Studio.
- Потоки
Пользователи
потоки в Workspace Studio, чтобы автоматизировать задачи в Google Workspace и других сервисах. Flows глубоко интегрированы в систему, учитывают контекст и могут использовать ИИ.
- Шаг
Один шаг в автоматизированном процессе потока. По сути, это одна задача в последовательности задач, которые следуют за начальным событием. Каждый шаг выполняется синхронно, то есть он завершает свою операцию до начала следующего шага в последовательности. Пользователи могут задавать порядок шагов, настраивая логику выполнения задач. У шагов могут быть входные и выходные данные, но это не обязательно. Примеры шагов: "отправить электронное письмо", "опубликовать сообщение в чат-группе" и "задать вопрос Gemini". Шаги могут включать задачи, выполняемые вне Google Workspace, например создание потенциального клиента в CRM.
- Starter
- Точка входа в автоматизированный процесс. В интерфейсе он представлен как Starter, а в схеме манифеста и Google Workspace Studio API – как
workflowTrigger. Шаг выполняет синхронное действие в середине последовательности, а условие находится в начале потока и ожидает событие (от приложений Google Workspace или сторонних веб-перехватчиков). После активации он фиксирует сведения о событии, выводит переменные исходных данных и запускает выполнение потока. - Входная переменная
- Входные переменные принимаются шагами. Входные переменные задаются пользователем на карточке конфигурации шага во время его настройки. Например, можно запросить адрес электронной почты, дату и время или запрос к Gemini.
- Выходная переменная
- Выходные переменные возвращаются шагами и могут быть отправлены на другой шаг. Например, вы можете использовать выходную переменную, чтобы передать адрес электронной почты на другой шаг, где он будет использоваться для указания получателя письма.
- Динамическая переменная
- Переменная, данные которой можно определить только при настройке пользователем последовательности действий. Например, в Google Формах могут быть разные вопросы и ответы. Количество вопросов и ответов (а также их содержание) нельзя определить, пока определенная форма не начнет поток. Динамические переменные учитывают этот случай.
- Специальный ресурс
- Специальная структура данных, которую можно задать для группировки нескольких переменных. Например, чтобы создать лида в CRM, передайте специальный ресурс, содержащий адрес электронной почты, почтовый адрес и имя.
- Карта
Блок для создания пользовательских интерфейсов в дополнениях. Карточки поддерживают определенную разметку, интерактивные элементы интерфейса, такие как кнопки, и мультимедийный контент, например изображения. У карточек есть специальные функции для создания процессов:
IncludeVariables– свойство, которое позволяет включать динамические переменные.Type– элемент, определяющий тип данных, которые ожидаются во входных переменных;
- Журнал активности
- Описывает, что происходит при запуске потока. По умолчанию в журналах активности указывается название события или шага, статически определенное в манифесте. Вы также можете предоставить собственные журналы активности.
Начать
Процессы создаются на платформе дополнений в Google Workspace. Если у вас уже есть дополнение, вы можете расширить его функциональность, добавив в него потоки. Для этого нужно обновить манифест, добавив в него раздел, относящийся к потокам.
Если вы только начинаете работать с API, изучите следующие руководства для разработчиков, а также пошаговые инструкции и лабораторные работы.
Краткое руководство
Чтобы создать и протестировать свой первый собственный шаг, следуйте инструкциям в кратком руководстве.
Практические работы
Чтобы посмотреть примеры реализации триггеров и шагов, ознакомьтесь со следующими практическими работами:
Руководства для разработчиков
Чтобы продолжить создание и настройку триггеров и шагов, ознакомьтесь со следующими руководствами: