This document lists the events and parameters for
various types of
Gemini in Workspace Apps activity events. You can retrieve these events by
calling Activities.list()
with applicationName=gemini_in_workspace_apps
.
Note: 'Gemini in Workspace apps' logs will be available starting 2025-06-20T00:00:00Z. From this date forward, a rolling history of up to 180 days will be maintained.
Gemini in Workspace Apps Utilization Event
Event type for usage related events.
Events of this type are returned with type=ai_usage_event
.
Gen AI Usage
Event is triggered when a user performs an action that uses Gemini in any of the Workspace apps.
feature_utilization
action
string
Action performed by the user within a Workspace application, initiated or assisted by Gemini. Possible values:
-
generate_starter_tile_prompts
Suggests Gemini features to try out through tiles in the sidepanel. -
suggest_full_replies
Replies suggested by Gemini on emails, conversations, etc. -
list_action_items_refinement
Action items on meet transcript. -
condense
Condenses the selected paragraph in documents. -
paraphrase
Rephrases selected paragraphs in documents. -
generate_talkshow
Generates audio podcasts from context. -
summarize_proactive_short
Summarizes content from a specified file. -
bulletize
Bulletises the selected paragraph in Google Docs. -
formalize
Formalizes the selected paragraph in documents. -
search_in_conversation
Searches within a conversation. -
match_writing_style
Matches the writing style of existing text. -
comment_conversation
Generates a conversational response within a comment thread context. -
ask_about_context
Used for asking Gemini questions about the user's context. -
generate_image_for_current_page
Image Generation used in slides. -
conversation
Chats with Gemini. -
proactive_suggestions_response
Generates proactive prompt suggestions. -
summarize_proactive
Summarizes background information proactively. -
generate_images_in_product
Generates an image. -
summarize
Summarizes short text. -
generate_starter_active_view
Generates suggested prompts to users that utilizes active context. -
generate_text
Generates text from a prompt to assist with writing. -
generate_document
Generates a full document from a prompt. -
describe_gemini_uses
Describes Gemini uses in context. -
remove_background
Removes the background of an image. -
search_web
Searches the web for given prompt. -
summarize_long
Summarizes long-form text. -
classic_use_case_gemini
Summarizes any action performed on the Gemini app. -
proofread
Proofreads content, such as emails and documents, using Gemini. -
elaborate
Elaborates content, such as emails and documents, using Gemini. -
summarize_items
Summarizes content in capabilities such as email and documents using Gemini. -
expand
Expansion of content in capabilities such as emails and documents by Gemini. -
create_faq
Creates a FAQ for a Drive folder or file. -
informalize
Converts text conversion to a casual tone requested by the user. -
ask_about_this_file
Summarizes the information about the file. -
summarize_unspecified_folder
Summarizes a folder action. -
suggest_replies
Generates suggested replies to users in conversations across applications. -
classic_use_case_proofread_conciseness
Generates shortened text on a document. -
generate_videos_in_product
Generates a video on user request on different workspace apps using SidePanel. -
outline
Generates an executive summary based on input text. -
generate_backgrounds
Generates background. -
catch_me_up
Analyzes new information in a user's Drive and provides a summary of recent activity, helping the user quickly get up to date. -
refine_phrasing
Refines text in Gmail and Docs. -
generate_starter_freeform
Provides starter tiles to help users get started in the Sidepanel. -
refine_content
Refines text in Gmail and Docs. -
summarize_file
Summarizes content from a specified file. -
replace_background
replace_background -
summarize_unspecified_file
Summarizes a file. -
outpaint
Used in image editing. -
summarize_conversation
Generates a summary based on a conversation of chat messages. -
auto_adjust_layout
Used to auto adjust layout in Slides. -
generate_text_completion
Used in auto-completing of text. -
generate_ai_function_response
Used in the =AI function in Sheet. -
generate_text_for_current_page
Generates body text for the current page. -
analyze_documents
Analyzes documents. -
generate_title_for_current_page
Generates a title for the current page. -
generate_next_steps
Generates next steps from the user's context. -
auto_proofread
Polishes draft text inline. -
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
Name of the Workspace application through which the action was performed. Possible values:
-
gemini_app
-
chat
-
classroom
-
docs
-
drive
-
gmail
-
keep
-
meet
-
sheets
-
slides
-
vids
event_
category
string
Event Category Name indicates the type of the generative AI action. Possible values:
-
active_conversations
Represents a conversation with Gemini. -
active_generate
Represents Gemini’s generation capabilities - Example: GENERATE_IMAGES or GENERATE_SLIDES. -
active_summarize
Represents Gemini’s summarization capabilities Ex: SUMMARIZE_THREAD. -
active_unspecified
Represents a category that is neither generate nor summarize. -
inactive
Represents a category where the user is not considered to be actively engaging with Gemini; that is not counted towards active usage. -
unknown
Represents a category that is not classified.
feature_
source
string
Identifies where a generative AI interaction originates within the user interface. Possible values:
-
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}