Gemini in Workspace Apps Activity Events

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

注意：Workspace 應用程式中的 Gemini 記錄將於 2025 年 6 月 20 日 00:00:00 協調世界時 (UTC) 起提供。自這天起，我們會保留最多 180 天的滾動式記錄。

Gemini 版 Workspace 應用程式使用量事件

使用情形相關事件的事件類型。這類事件會透過 type=ai_usage_event 傳回。

生成式 AI 用量

當使用者在任何 Workspace 應用程式中執行使用 Gemini 的動作時，系統就會觸發事件。

活動詳細資料
事件名稱	feature_utilization
參數	action string 使用者在 Workspace 應用程式中執行的動作，由 Gemini 啟動或協助執行。 可能的值： generate_starter_tile_prompts 透過側邊面板的方塊，建議可試用的 Gemini 功能。 suggest_full_replies Gemini 提供的電子郵件、對話等回覆建議 list_action_items_refinement Meet 轉錄稿上的待辦事項。 condense 在文件中濃縮所選段落。 paraphrase 重新表達文件中所選段落的內容。 generate_talkshow 根據內容產生音訊 Podcast。 summarize_proactive_short 摘要指定檔案的內容。 bulletize 在 Google 文件中將所選段落變更為項目符號。 formalize 將文件中所選段落轉換為正式文體。 search_in_conversation 搜尋對話內容。 match_writing_style 與現有文字的寫作風格一致。 comment_conversation 在留言串內容中產生對話回應。 ask_about_context 用於向 Gemini 詢問使用者脈絡相關問題。 generate_image_for_current_page 在簡報中使用的圖像生成功能。 conversation 與 Gemini 對話。 proactive_suggestions_response 產生主動提示建議。 summarize_proactive 主動摘錄背景資訊。 generate_images_in_product 會產生圖片。 summarize 產生簡短文字摘要。 generate_starter_active_view 為使用活動情境的使用者產生建議提示。 generate_text 使用文字提示生成文字，協助你撰寫內容。 generate_document 根據提示產生完整文件。 describe_gemini_uses 說明 Gemini 在脈絡中的用法。 remove_background 移除圖片背景。 search_web 在網路上搜尋指定提示。 summarize_long 摘要長篇文字。 classic_use_case_gemini 摘要說明在 Gemini 應用程式中執行的任何動作。 proofread 使用 Gemini 校對電子郵件和文件等內容。 elaborate 使用 Gemini 詳述電子郵件和文件等內容。 summarize_items 使用 Gemini 摘要電子郵件和文件等功能中的內容。 expand 透過 Gemini 擴充電子郵件和文件等功能的內容。 create_faq 為雲端硬碟資料夾或檔案建立常見問題。 informalize 將文字轉換為使用者要求的隨意語氣。 ask_about_this_file 摘要檔案資訊。 summarize_unspecified_folder 摘要資料夾動作。 suggest_replies 產生建議回覆，以便在跨應用程式對話中回覆使用者。 classic_use_case_proofread_conciseness 在文件中產生縮短的文字。 generate_videos_in_product 使用 SidePanel，根據使用者要求在不同工作區應用程式中產生影片。 outline 根據輸入的文字產生內容摘要。 generate_backgrounds 產生背景。 catch_me_up 會分析使用者雲端硬碟中的新資訊，並提供近期活動摘要，協助使用者快速掌握最新動態。 refine_phrasing 可在 Gmail 和 Google 文件中潤飾文字。 generate_starter_freeform 提供初始資訊方塊，協助使用者在側邊面板中開始使用。 refine_content 可在 Gmail 和 Google 文件中潤飾文字。 summarize_file 摘要指定檔案的內容。 replace_background replace_background summarize_unspecified_file 摘要檔案。 outpaint 用於圖片編輯。 summarize_conversation 根據即時通訊訊息對話產生摘要。 auto_adjust_layout 用於自動調整簡報檔中的版面配置。 generate_text_completion 用於自動完成文字。 generate_ai_function_response 用於試算表中的 =AI 函式。 generate_text_for_current_page 為目前頁面產生內文。 analyze_documents 分析文件。 generate_title_for_current_page 為目前頁面產生標題。 generate_next_steps 根據使用者情境產生後續步驟。 auto_proofread 在草稿中內嵌潤飾文字。 classic_use_case_meet_studio_look classic_use_case_meet_studio_sound conversation list_action_items summarize_executive_summary proactive_suggestions detect_schedule_intent user_confirmed_tools_operation generate_apps_search_overlay_suggestions suggest_reply_prompts summarize_dm summarize_space summarize_thread list_action_items_filtering list_action_items_proactive generate_nudge_prompts classic_use_case_meet_studio_lighting summarize_snippet add_to_calendar list_action_items_annotator classic_use_case_proofread_grammar classic_use_case_proofread_spelling generate_page_outline generate_folder_suggestions refine_friendly summarize_sales_lead refine_engaging refine_persuasive suggest_reply_sales trigger_golden_prompt custom_prompt summarize_space_comprehensive detect_schedule_intent_compose summarize_thread_comprehensive search_answer find_and_organize_within_folder generate_avatar_video chip_agent ask_about_unspecified_file evaluate_natural_language_condition brief generate_ai_function_response_in_batch suggest_time categorize_content find_and_organize_items_to_location compare_unspecified_files describe_image suggest_prompts report_unspecified_files classic_use_case_preset_voiceover classic_use_case_sheets_turbofill generate_form classic_use_case_proofread_sentence_splitting classic_use_case_proofread_word_choice classic_use_case_proofread_active_voice classic_use_case_teleprompter_word_match generate_form_questions classic_use_case_generate_questions classic_use_case_generate_rubric classic_use_case_generate_vocab_list classic_use_case_generate_lesson_plan classic_use_case_generate_choice_board classic_use_case_relevel_content classic_use_case_generate_story classic_use_case_generate_text_dependent_questions classic_use_case_generate_common_misconceptions classic_use_case_generate_hooks classic_use_case_generate_project_activities classic_use_case_generate_informative_articles 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 互動在使用者介面中的來源。可能的值： adaptive_audio chat_with_gemini classroom_gemini_education enhanced_smart_fill generate_background help_me_organize help_me_refine help_me_visualize help_me_write proofread remove_image_background side_panel studio_light studio_look studio_sound 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}