Gemini in Workspace Apps Activity Events

本文档列出了各种类型的 Workspace 应用中的 Gemini 活动事件的事件和参数。您可以通过 调用 Activities.list() 并使用 applicationName=gemini_in_workspace_apps来检索这些事件。

注意：自 2025-06-20T00:00:00Z 起，您将可以查看“Workspace 应用中的 Gemini”日志。自此日期起，系统将保留最多 180 天的滚动历史记录。

Workspace 应用中的 Gemini 使用情况事件

与使用情况相关的事件的事件类型。 此类事件会返回 type=ai_usage_event。

生成式 AI 用量

当用户在任何 Workspace 应用中执行使用 Gemini 的操作时，系统会触发此事件。

事件详情
事件名称	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 课堂：用户点击“生成音频课程”按钮，系统会根据输入的年级、主题或内容生成音频课程，包括幻灯片形式的文字稿。 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 课堂：用户点击“生成演示文稿大纲”按钮，系统会根据输入的年级、主题和演示文稿长度生成幻灯片演示文稿。 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 课堂：用户点击“创建词汇表”页面上的“生成”按钮，系统会根据输入的年级、主题和教学材料生成词汇表和定义列表。 classic_use_case_meet_studio_lighting Meet：改善用户在光线不足条件下的视频效果，并允许用户使用虚拟光源进行更精细的控制。 classic_use_case_meet_studio_look Meet：在需要时锐化用户特征。 classic_use_case_meet_studio_sound Meet：在需要时提高音质。尤其是在使用蓝牙窄带麦克风时。 classic_use_case_meet_take_notes_for_me_session Meet：在使用“帮我做笔记”功能时，为会议生成文档。 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 聊天：在侧边栏中描述 Gemini 的使用场景。 Meet：侧边栏中的“Gemini 在 Google Meet 中可以做什么”。 表格：用户要求 Gemini 描述其功能或建议使用该功能的方式。 . elaborate Gmail：当用户在优化菜单中点击“详细说明”时，展开草稿的内容。 formalize Gmail：当用户在优化菜单中点击“正式化”时，将草稿的内容正式化。 幻灯片：对应于文本框下“帮我写”入口点中的“更正式”按钮。Gemini 会返回所选文本框的改写版本，语气更正式。 . generate_ai_function_response 表格：Gemini 直接在单元格或范围内生成内容。当用户手动输入 =AI() 函数或使用代表用户在网格中生成内容的功能时，系统会触发此操作。 generate_avatar_video Vids：当用户提供脚本并在 AI 虚拟形象侧边栏中点击“生成”时，生成数字虚拟形象的视频。 generate_document Vids：根据提示、任何附件、生成的大纲和“入门”对话框中的受支持模板生成 Google Vid。 幻灯片：根据提示以及“入门”对话框中提供的任何来源和样式生成 Google 幻灯片演示文稿。 . generate_form 表单：根据用户提示生成表单；当用户在“帮我创建”对话框中点击“创建”时触发。创建新表单时，或者用户点击“帮我创建”按钮时，系统会显示该对话框。 generate_form_questions 表单：当点击“建议问题”按钮时，为现有表单生成更多问题；该按钮会针对未发布的表单显示，前提是表单已包含一些内容（非默认标题且至少包含 2 个问题）。 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：当用户在“AI 视频剪辑”侧边栏中输入文本提示时，生成视频。 live_generate_document 文档：根据与用户的实时对话生成文档。 outpaint Vids：当用户在提示中请求扩绘并在“生成图片”侧边栏中点击“创建”时，生成所选图片的扩展版本，超出其原始边框。 paraphrase 幻灯片：对应于文本框下“帮我写”入口点中的“改写”按钮。Gemini 会返回以不同方式改写的所选文本。 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 聊天：当用户在聊天界面中点击云端硬盘文件预览卡片上的“总结”按钮时，在聊天侧边栏中生成文件摘要。 summarize_proactive 当侧边栏打开时，Gemini 会主动生成并显示检测到的活跃内容的摘要。 summarize_proactive_short Gemini 会为用户的内容生成简短的主动摘要或标题。 user_confirmed_tools_operation 用户在对话期间点击侧边栏中显示的按钮以确认操作。 app_name string 执行操作的 Workspace 应用的名称。 可能的值： gemini_app chat classroom docs drive gmail keep meet sheets slides vids event_category string 事件类别名称表示生成式 AI 操作的类型。 可能的值： active_conversations 表示与 Gemini 的对话。 active_generate 表示 Gemini 的生成功能 - 示例：GENERATE_IMAGES 或 GENERATE_SLIDES。 active_summarize 表示 Gemini 的总结功能，例如 SUMMARIZE_THREAD。 active_unspecified 表示既不生成也不总结的类别。 inactive 表示用户不被视为主动与 Gemini 互动的类别；不计入活跃使用量。 unknown 表示未分类的类别。 feature_source string 标识生成式 AI 互动在界面中的发起位置。 可能的值： ai_function 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 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}