Gemini in Workspace Apps Activity Events

В этом документе перечислены события и параметры для различных типов событий Gemini в приложениях Workspace. Чтобы получить эти события, вызовите метод Activities.list() с параметром applicationName=gemini_in_workspace_apps.

Примечание. Журналы Gemini в приложениях Workspace будут доступны с 20 июня 2025 г. (00:00:00 UTC). Начиная с этой даты будет храниться история за последние 180 дней.

Событие, связанное с использованием Gemini в приложениях Workspace

Тип события для событий, связанных с использованием. События этого типа возвращаются с type=ai_usage_event.

Использование генеративного ИИ

Событие активируется, когда пользователь выполняет действие, в котором задействован Gemini, в любом из приложений Workspace.

Сведения о трансляции
Название события feature_utilization
Параметры
action

string

Действие пользователя в приложении Workspace, инициированное Gemini или выполненное с помощью этого сервиса. Возможные значения:

  • add_to_calendar
    Gmail: пользователь добавил в календарь мероприятие, извлеченное из письма, с помощью Gemini.
  • auto_proofread
    Gmail: пример использования для улучшения черновика на уровне предложения. Он предлагает умные подсказки, которые помогают улучшить качество черновика.
  • bulletize
    Презентации: соответствует кнопке "Создать маркированный список" в точке входа генератора текстов под текстовым полем. Gemini возвращает выбранный текст, оформленный в виде маркированного списка.
  • classic_use_case_convert_rubric
    Класс. На странице создания задания пользователь нажимает "+ Критерий оценки", а затем "Преобразовать из файла", чтобы загрузить критерий оценки на основе файла на Диске.
  • classic_use_case_generate_audio_lesson
    Класс. Пользователь нажимает кнопку "Сгенерировать аудиоурок", чтобы создать аудиоурок, включая презентацию Google с расшифровкой, на основе указанного класса, темы или контента.
  • classic_use_case_generate_choice_board
    Класс. Пользователь нажимает кнопку "Сгенерировать" на странице "Создать матрицу выбора", чтобы создать матрицу с примерами упражнений для учащихся на основе указанного класса, темы и учебных материалов.
  • classic_use_case_generate_common_misconceptions
    Класс. Пользователь нажимает кнопку "Сгенерировать" на странице "Устранение распространенных заблуждений", чтобы создать список распространенных проблем, с которыми сталкиваются учащиеся, на основе введенных данных о классе и теме.
  • classic_use_case_generate_feedback
    Класс. Пользователь нажимает "Генератор текстов" на странице оценивания задания, чтобы создать комментарий к работе учащегося на основе оценки и темы отзыва.
  • classic_use_case_generate_hooks
    Класс. Пользователь нажимает кнопку "Сгенерировать" на странице "Создайте увлекательное введение", чтобы создать короткое упражнение для учащихся на основе указанного класса, урока и учебных материалов.
  • classic_use_case_generate_informative_articles
    Класс. Пользователь нажимает кнопку "Сгенерировать" на странице "Написать информационный текст", чтобы создать текст на указанную тему, подходящий для выбранного класса.
  • classic_use_case_generate_lesson_plan
    Класс. Пользователь нажимает кнопку "Создать план урока", чтобы сгенерировать план урока на основе указанного класса, темы и учебных материалов.
  • classic_use_case_generate_presentation
    Класс. Пользователь нажимает кнопку "Создать план презентации", чтобы сгенерировать презентацию Google на основе указанных класса, темы и длины презентации.
  • classic_use_case_generate_project_activities
    Класс. Пользователь нажимает кнопку "Сгенерировать проект", чтобы получить несколько идей для индивидуальных или групповых проектов на основе указанного класса, темы и учебных материалов.
  • classic_use_case_generate_questions
    Класс. Пользователь нажимает кнопку "Сгенерировать вопросы", чтобы получить список вопросов на основе указанного класса, темы и типа вопроса.
  • classic_use_case_generate_rubric
    Класс. Пользователь нажимает кнопку "Сгенерировать критерии" на странице создания критериев оценки, и на основе введенных данных (оценки, уровня успеваемости и инструкций к заданию) генерируются критерии оценки.
  • classic_use_case_generate_story
    Класс. Пользователь нажимает кнопку "Сгенерировать" на странице "Написать рассказ", и создается короткий рассказ на основе указанных класса, темы и ключевых слов.
  • classic_use_case_generate_text_dependent_questions
    Класс. Пользователь нажимает кнопку "Сгенерировать вопросы" на странице "Вопросы на понимание текста", и генерируется список вопросов на основе указанного класса, типа вопроса, навыков чтения и текстового запроса.
  • classic_use_case_generate_vocab_list
    Classroom. Пользователь нажимает кнопку "Сгенерировать" в инструменте "Создать список слов ", чтобы получить список слов и определений на основе указанного класса, темы и учебных материалов.
  • classic_use_case_meet_studio_lighting
    Meet: улучшает видео пользователя в условиях плохого освещения и позволяет использовать виртуальные источники света для более точного управления.
  • classic_use_case_meet_studio_look
    Meet: повышает резкость изображения пользователя, когда это необходимо.
  • classic_use_case_meet_studio_sound
    Meet: улучшает качество звука, когда это необходимо. Особенно это заметно при использовании узкополосного Bluetooth-микрофона.
  • classic_use_case_meet_take_notes_for_me_session
    Meet: генерирует документ для встреч, если использовалась функция "Сделай заметки для меня".
  • classic_use_case_notebooklm_generate_chat_response
    Генерирует ответ на запрос пользователя в разговорном стиле.
  • classic_use_case_notebooklm_generate_notebook_guide
    Генерирует руководство по блокноту на основе загруженных пользователем источников.
  • classic_use_case_notebooklm_generate_source_guide
    Генерирует руководство по выбранному пользователем источнику.
  • classic_use_case_notebooklm_generate_studio_artifact
    Генерирует объект студии на основе источников пользователя, когда пользователь запускает этот процесс.
  • classic_use_case_notebooklm_perform_source_discovery
    Находит потенциальные источники на основе параметров поиска, заданных пользователем.
  • classic_use_case_relevel_content
    Класс: пользователь нажимает кнопку "Сгенерировать" на странице изменения сложности текста, и генерируется обновленная версия указанного текста, подходящая для выбранного года обучения.
  • classic_use_case_sheets_turbofill
    Таблицы. Пользователь принимает умную подсказку, чтобы заполнить столбец текстовыми данными на основе другого столбца в таблице.
  • classic_use_case_suggest_time_reporting
    Gmail: пользователь принял предложенное Gemini время встречи, когда планировал ее с помощью функции "Помощь в выборе времени" при создании письма.
  • classic_use_case_teleprompter_word_match
    Vids. Используется для умного телесуфлера в студии звукозаписи, чтобы сопоставлять слова из скрипта с речью пользователя в реальном времени с помощью модели преобразования речи в текст.
  • classic_use_case_translate_text
    Класс. Пользователь нажимает кнопку "Перевести" на странице перевода текста, и введенный текст переводится на выбранный язык.
  • condense
    • Gmail: сокращает черновик, когда пользователь нажимает "Сократить" в меню доработки.
    • Презентации: соответствует кнопке "Сократить" в точке входа генератора текстов под текстовым полем. Gemini возвращает сокращенную версию выбранного текстового поля.
  • conversation
    Запрос отправляется на боковую панель Gemini. Это может сделать сам пользователь или другая функция от его имени (например, предложение в сетке).
  • custom_prompt
    Презентации: соответствует полю "Изменить с помощью запроса" в точке входа генератора текстов под текстовым полем. Gemini возвращает перефразированную версию выбранного текстового поля в соответствии с запросом пользователя.
  • describe_gemini_uses
    • Chat: описывает использование Gemini в контексте на боковой панели.
    • Meet: "Что может Gemini в Google Meet" на боковой панели.
    • Таблицы: пользователь просит Gemini описать свои возможности или предложить способы использования функции.
  • elaborate
    Gmail: расширяет содержимое черновика, когда пользователь нажимает "Дополнить" в меню уточнения.
  • formalize
    • Gmail: делает стиль черновика более формальным, когда пользователь нажимает "Официальный стиль" в меню доработки.
    • Презентации: соответствует кнопке "Более формально" в точке входа генератора текстов под текстовым полем. Gemini возвращает перефразированную версию выбранного текстового поля в более формальном тоне.
  • generate_ai_function_response
    Таблицы. Gemini генерирует контент прямо в ячейке или диапазоне. Оно срабатывает, когда пользователь вручную вводит функцию =AI() или использует функцию, которая генерирует контент в сетке от его имени.
  • generate_avatar_video
    Vids: генерирует видео с цифровым аватаром, когда пользователь предоставляет скрипт и нажимает "Сгенерировать" на боковой панели ИИ-аватара.
  • generate_document
    • Vids: генерирует видео Google Vids на основе запроса, прикрепленных файлов, сгенерированного плана и поддерживаемого шаблона из диалогового окна "Начало работы".
    • Презентации. Генерирует презентацию Google на основе запроса, а также любых предоставленных источников и стилей из диалогового окна "Начало работы".
  • generate_form
    Формы: генерирует форму на основе запроса пользователя; запускается, когда пользователь нажимает "Создать" в диалоговом окне генератора опросов. Диалоговое окно появляется при создании новой формы или когда пользователь нажимает кнопку "Генератор программ".
  • generate_form_questions
    Формы. При нажатии кнопки "Предложить вопросы" генерируются дополнительные вопросы для существующей формы. Кнопка показывается для неопубликованных форм, в которых уже есть контент (название, отличное от стандартного, и не менее двух вопросов).
  • generate_image_for_current_page
    Презентации: генерация изображений для слайдов без запроса. Пользователь вводит запрос, например "Предложи изображение для этого слайда". Сначала Gemini генерирует запрос для изображения, а затем использует его, чтобы создать изображения и показать их пользователю.
  • generate_images_in_product
    • Vids: генерирует изображение, когда пользователь вводит текстовый запрос и нажимает "Создать" на боковой панели "Создание изображений".
    • Meet: запускается с боковой панели, пользователь вводит текстовый запрос и нажимает кнопку "Создать образцы". Meet использует введенный текстовый запрос для создания нескольких изображений, которые пользователь может использовать в качестве фонового изображения.
    • Презентации: пользователь нажимает на кнопку "Генератор изображений" в Презентациях, и модель генерации изображений возвращает пользователю сгенерированные изображения.
  • generate_nudge_prompts
    Таблицы. Gemini предлагает пользователю попробовать функции или запросы с помощью умных подсказок в сетке.
  • generate_starter_active_view
    Gemini предлагает пользователям варианты запросов, в которых используется активный контекст.
  • generate_starter_freeform
    Генерирует ответ, когда пользователь нажимает на карточку.
  • generate_starter_tile_prompts
    Gemini показывает на боковой панели карточки с начальными вариантами запросов, которые помогают пользователям начать работу.
  • generate_table_name
    Таблицы. Gemini автоматически добавляет название таблицы (на основе ее содержимого) для новой таблицы, преобразованной из предложенной.
  • generate_text
    Gmail: генерирует черновик, когда пользователь нажимает "Создать" в окне генератора текстов.
  • generate_videos_in_product
    Vids. Генерирует видео, когда пользователь вводит текстовый запрос на боковой панели "Видеоклип, созданный ИИ".
  • live_generate_document
    Документы: генерировать документ на основе разговора с пользователем в реальном времени.
  • outpaint
    Vids: генерирует расширенную версию выбранного изображения, выходящую за его исходные границы, когда пользователь запрашивает дорисовку в своем запросе и нажимает "Создать" на боковой панели "Создать изображение".
  • paraphrase
    Презентации: соответствует кнопке "Перефразировать" в точке входа генератора текстов под текстовым полем. Gemini возвращает перефразированный текст.
  • proactive_daily_briefs
    Генерирует для пользователя проактивную сводку дня в Chat.
  • proactive_suggestions
    Генерирует текст для карточек умных подсказок на основе контекста.
  • proactive_suggestions_response
    Пользователь выбрал умную подсказку на боковой панели Gemini, и был сгенерирован ответ.
  • proofread
  • remove_background
    Vids. Удаляет фон выбранного изображения, делая его прозрачным, когда пользователь нажимает кнопку "Удалить фон" на плавающей панели инструментов изображения.
  • replace_background
    Vids: заменяет фон выбранного изображения, когда пользователь вводит запрос с описанием нового фона и нажимает "Создать" на боковой панели "Создание изображений".
  • search_web
    Пользователь выполнил поиск в интернете с помощью боковой панели Gemini.
  • suggest_time
    Календарь: запрошены предложения по времени встречи.
  • summarize
    Gemini обобщает текущий контекст.
  • summarize_document_comment_thread
    Обобщать цепочки комментариев в документе.
  • summarize_drive_homepage_doclist_files
    Показывает краткую сводку файла в списке файлов на главной странице Диска.
  • summarize_drive_homepage_doclist_files_long
    Показывает более подробную сводку файла, когда пользователь нажимает "Подробнее" в списке файлов на главной странице Диска.
  • summarize_file
    Chat: генерирует краткий пересказ файла на боковой панели чата, когда пользователь нажимает кнопку "Пересказать" на карточке предварительного просмотра файла на Диске в интерфейсе чата.
  • summarize_proactive
    Gemini автоматически генерирует и показывает краткий пересказ обнаруженного активного контента, когда открыта боковая панель.
  • summarize_proactive_short
    Gemini генерирует краткий пересказ или название для контента пользователя.
  • user_confirmed_tools_operation
    Пользователь нажимает кнопки, которые появляются на боковой панели, чтобы подтвердить операцию во время разговора.
app_name

string

Название приложения Workspace, через которое было выполнено действие. Возможные значения:

  • gemini_app
  • chat
  • classroom
  • docs
  • drive
  • gmail
  • keep
  • meet
  • notebooklm
    Gemini Notebook.
  • sheets
  • slides
  • vids
event_category

string

Название категории события указывает на тип действия генеративного искусственного интеллекта. Возможные значения:

  • active_conversations
    Представляет разговор с Gemini.
  • active_generate
    Возможности генерирования Gemini, например GENERATE_IMAGES или GENERATE_SLIDES.
  • active_summarize
    Представляет возможности краткого пересказа Gemini, например SUMMARIZE_THREAD.
  • active_unspecified
    Представляет категорию, отличную от генерирования или краткого пересказа.
  • inactive
    Активное взаимодействие пользователя с Gemini не зафиксировано (не расценивается как активное использование).
  • unknown
    Категория не классифицирована.
feature_source

string

Определяет источник взаимодействия с генеративным искусственным интеллектом в пользовательском интерфейсе. Возможные значения:

  • ai_function
  • ask_gemini
    Спросить Gemini в Chat.
  • chat_with_gemini
  • classroom_gemini_education
  • drive_help_me_organize
  • enhanced_smart_fill
  • generate_background
  • help_me_refine
  • help_me_schedule
  • help_me_visualize
  • help_me_write
  • notebooklm
    Gemini Notebook.
  • proofread
  • remove_image_background
  • search_ai_overview
  • side_panel
  • studio_light
  • studio_look
  • studio_sound
  • take_notes_for_me
  • workflows_creation
  • workflows_execution
Образец запроса
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/gemini_in_workspace_apps?eventName=feature_utilization&maxResults=10&access_token=YOUR_ACCESS_TOKEN
Формат сообщений в консоли администратора
{actor} used Gen AI in {app_name}