Gemini in Workspace Apps Activity Events

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

注意：自 2025 年 6 月 20 日 00:00:00 (世界標準時間) 起，您將可查看「Gemini in Workspace 系列應用程式」記錄。自此日期起，系統會保留最多 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_relevel_content Classroom：使用者按一下「調整文字複雜度」頁面上的「生成」按鈕，系統就會根據輸入的年級，生成指定文字的更新版本。 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 Classroom：使用者點選「翻譯文字」頁面上的「翻譯」按鈕，即可將輸入文字翻譯成所選語言。 condense Gmail：使用者點選潤飾選單中的「縮短」時，會縮短草稿內容。 簡報：對應文字方塊下「幫我寫」進入點的「縮短」按鈕。Gemini 會傳回所選文字方塊的簡短版本。 。 conversation 將提示提交至 Gemini 側邊面板。這項操作可由使用者直接啟動，或由其他功能代表使用者啟動 (例如格線上的建議)。 custom_prompt 簡報：對應於文字方塊下「幫我寫」進入點的「使用提示修改」輸入內容。Gemini 會根據使用者的提示，重新撰寫所選文字方塊的內容。 describe_gemini_uses Chat：在側邊面板中說明 Gemini 的用途。 Meet：側邊面板中的「Google Meet 中的 Gemini 可提供什麼協助？」。 Google 試算表：使用者要求 Gemini 說明功能，或建議使用方式。 。 elaborate Gmail：使用者在修正選單中點選「詳細說明」時，會展開草稿內容。 formalize Gmail：使用者在潤飾選單中點選「正式」時，系統會將草稿內容改為正式語氣。 Google 簡報：對應於文字方塊下方「幫我寫」進入點的「更正式」按鈕。Gemini 會傳回所選文字方塊的改寫版本，行文語氣更正式。 。 generate_ai_function_response 試算表：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：使用者輸入文字提示並在「生成圖片」側欄中點選「建立」時，系統會生成圖片。 Google Meet：從側邊面板觸發，使用者輸入文字提示並點選「建立樣本」按鈕；Google Meet 會使用輸入的文字提示生成幾張圖片，使用者可將這些圖片做為視覺背景圖片。 簡報：使用者點選簡報中的「幫我繪圖」進入點；圖片模型會將生成的圖片傳回給使用者。 。 generate_nudge_prompts Google 試算表：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 影片片段」側欄中輸入文字提示時，系統會生成影片。 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 對話：使用者在對話 UI 中點選雲端硬碟檔案預覽資訊卡上的摘要按鈕時，會在對話側邊面板中產生檔案摘要。 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}