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}