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}

