Gemini in Workspace Apps Activity Events

本文列出各種 Gemini in Workspace 應用程式活動事件的事件和參數。如要擷取這些事件,請使用 applicationName=gemini_in_workspace_apps 呼叫 Activities.list()。

注意:「Gemini in Workspace 應用程式」記錄將於 2025-06-20T00:00:00Z 起提供。自該日期起,系統會保留最多 180 天的記錄。

Gemini in Workspace 應用程式使用事件

用量相關事件的事件類型。 這類事件會與 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
    Classroom:使用者在作業建立頁面依序點選「+ 評分量表」和「從檔案轉換」,即可根據輸入的雲端硬碟檔案上傳評分量表。
  • classic_use_case_generate_audio_lesson
    Classroom:使用者點選「生成音訊課程」按鈕,系統會根據輸入的年級、主題或內容,生成音訊課程,包括轉錄稿的 Google 簡報。
  • classic_use_case_generate_choice_board
    Classroom:使用者在「建立活動選項板」頁面點選「生成」按鈕,系統會根據輸入的年級、主題和教材,生成學生練習範例板。
  • classic_use_case_generate_common_misconceptions
    Classroom:使用者在「解決常見錯誤觀念」頁面點選「生成」按鈕,系統會根據輸入的年級和主題,生成學生常見問題清單。
  • classic_use_case_generate_feedback
    Classroom:使用者在作業評分頁面點選「幫我寫」,系統會根據輸入的成績和意見回饋主題,生成學生作業的評語。
  • classic_use_case_generate_hooks
    Classroom:使用者在「設計引人入勝的開場白」頁面點選「生成」按鈕,系統就會根據輸入的年級、課程和教材,生成簡短的學生練習題。
  • classic_use_case_generate_informative_articles
    Classroom:使用者在「撰寫實用內容」頁面點選「生成」按鈕,系統就會根據輸入的主題和年級生成合適的文字。
  • classic_use_case_generate_lesson_plan
    Classroom:使用者點選「生成教案」按鈕,系統會根據輸入的年級、主題和教材生成教案。
  • classic_use_case_generate_presentation
    Classroom:使用者點選「生成簡報大綱」按鈕,系統會根據輸入的年級、主題和簡報長度,生成 Google 簡報。
  • classic_use_case_generate_project_activities
    Classroom:使用者點選「生成專案」按鈕,系統會根據輸入的年級、主題和教材,生成多個個人或小組專案構想。
  • classic_use_case_generate_questions
    Classroom:使用者點選「生成問題」按鈕,系統會根據輸入的年級、主題和問題類型,生成問題清單。
  • classic_use_case_generate_rubric
    Classroom:使用者在「建立評分量表」頁面點選「生成條件」按鈕,系統就會根據輸入的年級、表現程度和作業操作說明,生成評分量表。
  • classic_use_case_generate_story
    Classroom:使用者在「寫故事」頁面點選「生成」按鈕,系統會根據輸入的年級、主題和關鍵字生成短篇故事。
  • classic_use_case_generate_text_dependent_questions
    Classroom:使用者在「設計閱讀理解測驗題目」頁面點選「生成題目」按鈕,系統會根據輸入的年級、題目類型、閱讀技巧和文字提示詞,生成題目清單。
  • 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:視需要提升音質。尤其是使用藍牙窄頻麥克風時。
  • 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
    使用者啟動後,系統會根據使用者提供的來源生成 Studio 構件。
  • classic_use_case_notebooklm_perform_source_discovery
    根據使用者輸入的探索參數,探索潛在來源選項。
  • classic_use_case_relevel_content
    Classroom:使用者點選「調整文字複雜度」頁面的「生成」按鈕,系統就會根據輸入的年級,生成指定文字的更新版本。
  • 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
    Classroom:使用者在「翻譯文字」頁面點選「翻譯」按鈕,將輸入的文字翻譯成所選語言。
  • condense
    • Gmail:使用者在潤飾選單中點選「精簡」時,縮短草稿內容。
    • 簡報:對應至文字方塊下方「幫我寫」進入點中的「精簡」按鈕。Gemini 會傳回所選文字方塊的精簡版本。
    。
  • conversation
    在 Gemini 側邊面板輸入提示。這項操作可由使用者直接啟動,或由其他功能代表使用者啟動 (例如畫面上的建議)。
  • custom_prompt
    Google 簡報:對應至文字方塊下方「幫我寫」入口中的「使用提示修改」輸入內容。Gemini 根據使用者提示,傳回所選文字方塊的改寫版本。
  • describe_gemini_uses
    • Chat:在側邊面板中說明 Gemini 的用途。
    • Meet:側邊面板中的「Google Meet 中的 Gemini 可提供什麼協助」。
    • 試算表:使用者要求 Gemini 說明功能,或建議使用方式。
    。
  • elaborate
    Gmail:使用者在調整選單中點選「詳細說明」時,展開草稿內容。
  • formalize
    • Gmail:使用者在潤飾選單中點選「使用正式語氣」後,系統會將草稿內容改為正式語氣。
    • 簡報:對應至文字方塊下方「幫我寫」進入點中的「更正式」按鈕。Gemini 會傳回所選文字方塊的改寫版本,語氣更正式。
    。
  • generate_ai_function_response
    Google 試算表:Gemini 會直接在儲存格或範圍中生成內容。當使用者手動輸入 =AI() 函式,或使用功能代為在格線中生成內容時,就會觸發這項事件。
  • generate_avatar_video
    Vids:使用者提供腳本,並在 AI 虛擬化身側欄中點選「生成」後,即可生成數位虛擬化身影片。
  • generate_document
    • Vids:根據提示、任何附加檔案、生成的影片大綱,以及「開始使用」對話方塊中支援的範本,生成 Google Vids 影片。
    • 簡報:根據「開始使用」對話方塊中的提示、提供的來源和樣式,生成 Google 簡報。
    。
  • generate_form
    表單:根據使用者提示詞生成表單;當使用者在「幫我建立」對話方塊中點選「建立」時觸發。建立新表單或點選「幫我建立」按鈕時,就會看到這個對話方塊。
  • generate_form_questions
    Google 表單:點按「建議問題」按鈕,即可為現有表單生成更多問題。如果表單尚未發布,且已有部分內容 (非預設標題和至少 2 個問題),就會顯示這個按鈕。
  • generate_image_for_current_page
    Google 簡報:不需提示詞,即可生成投影片圖片。使用者輸入提示,例如「建議適合這張投影片的圖片」。Gemini 會先生成圖片提示,再根據提示生成圖片並傳回給使用者。
  • generate_images_in_product
    • Vids:使用者在「生成圖片」側欄中輸入文字提示詞,並點按「建立」後,系統就會生成圖片。
    • Meet:從側邊面板觸發,使用者輸入文字提示詞,然後點選「建立範例」按鈕。Meet 會根據輸入的文字提示詞生成幾張圖片,使用者可將這些圖片設為視覺背景。
    • Google 簡報:使用者在 Google 簡報中點選「幫我繪圖」進入點,圖像模型會將生成的圖像傳回給使用者。
    。
  • generate_nudge_prompts
    試算表: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 短片」側欄輸入文字提示詞,即可生成影片。
  • live_generate_document
    文件:根據與使用者的即時對話生成文件。
  • outpaint
    Vids:使用者在提示詞中要求外擴圖片,並在「生成圖片」側欄中點選「建立」時,系統會生成所選圖片的擴增版本,超出原始邊界。
  • paraphrase
    Google 簡報:對應至文字方塊下方「幫我寫」入口中的「改寫」按鈕。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:使用者在 Chat UI 點選雲端硬碟檔案預覽資訊卡的摘要按鈕時,在 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

「事件類別名稱」代表生成式 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
  • ask_gemini
    在 Chat 中問問 Gemini。
  • 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}