Gemini in Workspace Apps Activity Events

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

注意：“Workspace 应用中的 Gemini”日志将从 2025-06-20T00:00:00Z 开始提供。自此日期起，系统将保留最多 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 Google 幻灯片：对应于文本框下“帮我写”入口点中的“生成项目符号”按钮。Gemini 会返回以项目符号形式整理的所选文字。 classic_use_case_convert_rubric Google 课堂：用户在作业创建页面上点击“+ 评分标准”，然后点击“从文件转换”，系统会根据输入的云端硬盘文件上传评分标准。 classic_use_case_generate_audio_lesson Classroom：用户点击“生成音频课程”按钮，系统会根据输入的年级、主题或内容生成音频课程，包括转写内容的 Google 幻灯片演示文稿。 classic_use_case_generate_choice_board Google 课堂：用户点击“制作选项板”页面上的“生成”按钮，系统会根据输入的年级、主题和教学材料生成包含学生练习示例的选项板。 classic_use_case_generate_common_misconceptions Google 课堂：用户点击“解决常见误解”页面上的“生成”按钮，系统会根据输入的年级和主题生成学生面临的常见问题列表。 classic_use_case_generate_feedback Google 课堂：用户点击作业评分页面上的“帮我写”，系统会根据输入的成绩和反馈主题生成有关学生提交的作业的评论。 classic_use_case_generate_hooks Google 课堂：用户点击“打造引人入胜的开头”页面上的“生成”按钮，系统会根据输入的年级、课程和教学材料生成简短的学生练习。 classic_use_case_generate_informative_articles Google 课堂：用户点击“撰写说明性文字”页面上的“生成”按钮，系统会生成与输入主题相符且适合输入年级的文字。 classic_use_case_generate_lesson_plan Google 课堂：用户点击“生成课程计划”按钮，系统会根据输入的年级、主题和教学材料生成课程计划。 classic_use_case_generate_presentation Google 课堂：用户点击“生成演示文稿大纲”按钮，系统会根据输入的年级、主题和演示文稿长度生成 Google 幻灯片演示文稿。 classic_use_case_generate_project_activities Google 课堂：用户点击“生成项目”按钮，系统会根据输入的年级、主题和教学材料生成若干个人或小组项目创意。 classic_use_case_generate_questions Classroom：用户点击“生成问题”按钮，系统会根据输入的年级、主题和问题类型生成问题列表。 classic_use_case_generate_rubric Google 课堂：用户点击“创建评分标准”页面上的“生成评分标准”按钮，系统会根据输入的年级、表现等级和作业说明生成评分标准。 classic_use_case_generate_story Google 课堂：用户在“写故事”页面上点击“生成”按钮，系统会根据输入的年级、主题和关键字生成一个短故事。 classic_use_case_generate_text_dependent_questions Google 课堂：用户点击“生成问题”按钮，系统会根据输入的年级、问题类型、阅读技能和文本提示生成问题列表。 classic_use_case_generate_vocab_list Google 课堂：用户点击“创建词汇表”中的“生成”按钮，系统会根据输入的年级、主题和教学材料生成词汇和定义列表。 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 Google 课堂：用户点击“调整文本难度”页面上的“生成”按钮，系统会生成适合输入年级的指定文本的更新版本。 classic_use_case_sheets_turbofill Google 表格：用户接受主动建议，根据表格中的另一列填充包含文本数据的列。 classic_use_case_suggest_time_reporting Gmail：用户在撰写邮件时使用“帮我安排会议”功能安排会议，并接受了 Gemini 生成的时间建议。 classic_use_case_teleprompter_word_match Vids：用于录制工具智能提词器，使用语音转文字模型将脚本中的文字与用户的语音实时匹配。 classic_use_case_translate_text Google 课堂：用户点击“翻译”按钮，系统会将输入文本翻译成所选语言。 condense Gmail：当用户在优化菜单中点击“缩短”时，缩短草稿的内容。 Google 幻灯片：对应于文本框下“帮我写”入口点中的“缩短”按钮。Gemini 返回所选文本框的缩短版本。 。 conversation 向 Gemini 侧边栏提交提示。此操作可由用户直接发起，也可由代表用户的其他功能（例如网格内建议）发起。 custom_prompt Google 幻灯片：对应于文本框下“帮我写”入口点中的“使用提示修改”输入。Gemini 会根据用户的提示返回所选文本框的改写版本。 describe_gemini_uses 聊天：描述侧边栏中的 Gemini 用途。 Meet：侧边栏中的“Gemini 在 Google Meet 中可提供哪些帮助”。 Google 表格：用户要求 Gemini 描述其功能或建议使用该功能的方式。 。 elaborate Gmail：当用户在优化菜单中点击“详细说明”时，展开草稿的内容。 formalize Gmail：当用户在优化菜单中点击“正式化”时，将草稿内容正式化。 Google 幻灯片：对应于文本框下“帮我写”入口点中的“更正式”按钮。Gemini 会返回所选文本框的改写版本，语气更加正式。 。 generate_ai_function_response Google 表格：Gemini 直接在单元格或单元格范围内生成内容。当用户手动输入 =AI() 函数或使用可代表其在网格中生成内容的功能时，系统会触发此事件。 generate_avatar_video Vids：当用户提供脚本并在 AI 虚拟形象边栏中点击“生成”时，生成数字虚拟形象的视频。 generate_document Vids：根据提示、任何附加文件、生成的视频大纲和“开始使用”对话框中的受支持模板生成 Google Vids 视频。 幻灯片：根据“开始使用”对话框中的提示以及提供的任何来源和样式，生成 Google 幻灯片演示文稿。 。 generate_form 表单：根据用户提示生成表单；当用户在“帮我创作”对话框中点击“创建”时触发。在创建新表单时，或者在用户点击“帮我创作”按钮时，系统会显示此对话框。 generate_form_questions 表单：点击“建议问题”按钮时，为现有表单生成更多问题；该按钮仅在未发布的表单已包含一些内容（非默认标题和至少 2 个问题）时显示。 generate_image_for_current_page Google 幻灯片：无需提示即可为幻灯片生成图片。用户输入“为这张幻灯片推荐一张图片”之类的提示。Gemini 会先生成图片提示，然后使用该提示生成图片并返回给用户。 generate_images_in_product Vids：当用户在“生成图片”边栏中输入文本提示并点击“创建”时，系统会生成图片。 Meet：从侧边栏触发，用户输入文字提示并点击“创建示例”按钮；Meet 将使用输入的文字提示生成一些图片，用户可将这些图片用作视觉背景图片。 Google 幻灯片：用户点击幻灯片中的“帮我画”入口点；图片模型将生成的图片返回给用户。 。 generate_nudge_prompts Google 表格：Gemini 会通过网格内建议主动向用户建议可尝试的功能或提示。 generate_starter_active_view Gemini 会利用有效上下文为用户生成建议的初始提示。 generate_starter_freeform 在点击初始功能块时生成回答。 generate_starter_tile_prompts Gemini 会在侧边栏中以功能块的形式显示初始的半情境化起始提示，帮助用户快速上手。 generate_table_name Google 表格：Gemini 会根据表格内容，自动为通过表格转换建议新转换的表格添加表格名称。 generate_text Gmail：当用户点击“帮我写”提示输入框中的“创建”时，系统会生成智能草稿。 generate_videos_in_product Vids：当用户在“AI 视频片段”边栏中输入文本提示时，生成视频。 outpaint Vids：当用户在提示中请求扩绘，并在“生成图片”边栏中点击“创建”时，系统会生成所选图片的扩展版本，该版本会超出图片的原始边框。 paraphrase Google 幻灯片：对应于文本框下“帮我写”入口点中的“改写”按钮。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}