Gemini in Workspace Apps Activity Events

Questo documento elenca gli eventi e i parametri per i vari tipi di eventi di attività di Gemini nelle app Workspace. Puoi recuperare questi eventi chiamando Activities.list() con applicationName=gemini_in_workspace_apps.

Nota: i log "Gemini nelle app Workspace" saranno disponibili a partire dal 20/06/2025T00:00:00Z. A partire da questa data, verrà mantenuta una cronologia continua di un massimo di 180 giorni.

Evento di utilizzo di Gemini nelle app Workspace

Tipo di evento per gli eventi relativi all'utilizzo. Gli eventi di questo tipo vengono restituiti con type=ai_usage_event.

Utilizzo dell'AI generativa

L'evento viene attivato quando un utente esegue un'azione che utilizza Gemini in una qualsiasi delle app Workspace.

Dettagli dell'evento
Nome evento feature_utilization
Parametri
action

string

Azione eseguita dall'utente all'interno di un'applicazione Workspace, avviata o assistita da Gemini. Valori possibili:

  • add_to_calendar
    Gmail: l'utente ha aggiunto al proprio calendario un evento estratto dalla propria email utilizzando Gemini.
  • auto_proofread
    Gmail: caso d'uso per perfezionare una bozza in linea con una granularità minima a livello di frase. Fornisce suggerimenti proattivi per migliorare la qualità della bozza.
  • bulletize
    Presentazioni: corrisponde al pulsante "Crea elenco puntato" nel punto di accesso di Aiutami a scrivere sotto la casella di testo. Gemini restituisce il testo selezionato organizzato in un elenco puntato.
  • classic_use_case_convert_rubric
    Classroom: l'utente fa clic su "+ Griglia", quindi su "Converti da file" nella pagina di creazione del compito, che carica una griglia di valutazione basata sul file di Drive di input.
  • classic_use_case_generate_audio_lesson
    Classroom: l'utente fa clic sul pulsante "Genera lezione audio", che genera una lezione audio, inclusa una presentazione di Presentazioni della trascrizione, in base al livello, all'argomento o ai contenuti inseriti.
  • classic_use_case_generate_choice_board
    Classroom: l'utente fa clic sul pulsante "Genera" nella pagina Crea una choice board, che genera una bacheca di esercizi di esempio per gli studenti in base al livello, all'argomento e ai materiali didattici inseriti.
  • classic_use_case_generate_common_misconceptions
    Classroom: l'utente fa clic sul pulsante "Genera" nella pagina Affronta le convinzioni errate comuni, che genera un elenco di problemi comuni che gli studenti devono affrontare, in base al livello e all'argomento inseriti.
  • classic_use_case_generate_feedback
    Classroom: l'utente fa clic su "Aiutami a scrivere" nella pagina di valutazione dei compiti, che genera un commento sul compito inviato dallo studente, in base al voto inserito e all'argomento del feedback.
  • classic_use_case_generate_hooks
    Classroom: l'utente fa clic sul pulsante"Genera " nella pagina Crea un hook accattivante, che genera un breve esercizio per gli studenti, in base al livello, alla lezione e ai materiali didattici inseriti.
  • classic_use_case_generate_informative_articles
    Classroom: l'utente fa clic sul pulsante "Genera" nella pagina Scrivi un testo informativo, che genera un testo che descrive l'argomento di input, appropriato per il livello scolastico di input.
  • classic_use_case_generate_lesson_plan
    Classroom: l'utente fa clic sul pulsante "Genera programma della lezione", che genera un programma della lezione in base al livello, all'argomento e ai materiali didattici inseriti.
  • classic_use_case_generate_presentation
    Classroom: l'utente fa clic sul pulsante "Genera struttura della presentazione", che genera una presentazione di Presentazioni in base al livello, all'argomento e alla lunghezza della presentazione inseriti.
  • classic_use_case_generate_project_activities
    Classroom: l'utente fa clic sul pulsante "Genera progetto", che genera diverse idee di progetti individuali o di gruppo, in base al livello, all'argomento e ai materiali didattici inseriti.
  • classic_use_case_generate_questions
    Classroom: l'utente fa clic sul pulsante "Genera domande", che genera un elenco di domande in base al livello, all'argomento e al tipo di domanda inseriti.
  • classic_use_case_generate_rubric
    Classroom: l'utente fa clic sul pulsante "Genera criteri" nella pagina Crea una griglia, che genera una griglia di valutazione in base al voto, al livello di rendimento e alle istruzioni del compito inseriti.
  • classic_use_case_generate_story
    Classroom: l'utente fa clic sul pulsante "Genera" nella pagina Scrivi una storia, che genera una breve storia in base all'anno, all'argomento e alle parole chiave inseriti.
  • classic_use_case_generate_text_dependent_questions
    Classroom: l'utente fa clic sul pulsante"Genera domande " nella pagina Sviluppa domande di comprensione della lettura, che genera un elenco di domande in base al livello, al tipo di domanda, alle competenze di lettura e al prompt testuale inseriti.
  • classic_use_case_generate_vocab_list
    Classroom: l'utente fa clic sul pulsante"Genera " in Crea un elenco di vocaboli, che genera un elenco di vocaboli e definizioni in base al livello, all'argomento e ai materiali didattici inseriti.
  • classic_use_case_meet_studio_lighting
    Meet: migliora il video dell'utente in condizioni di scarsa illuminazione e consente agli utenti di utilizzare sorgenti di luce virtuali per un controllo più granulare.
  • classic_use_case_meet_studio_look
    Meet: rende più nitidi i tratti del viso dell'utente quando necessario.
  • classic_use_case_meet_studio_sound
    Meet: migliora la qualità audio quando necessario. In particolare quando si utilizza un microfono Bluetooth a banda stretta.
  • classic_use_case_meet_take_notes_for_me_session
    Meet: genera un documento per le riunioni quando è stata utilizzata la funzionalità Prendi appunti per me.
  • classic_use_case_notebooklm_generate_chat_response
    Genera una risposta conversazionale alla query di un utente.
  • classic_use_case_notebooklm_generate_notebook_guide
    Genera una guida del notebook in base alle fonti caricate dall'utente.
  • classic_use_case_notebooklm_generate_source_guide
    Genera una guida alle fonti per una specifica fonte caricata quando viene selezionata dall'utente.
  • classic_use_case_notebooklm_generate_studio_artifact
    Genera un artefatto di studio in base alle fonti dell'utente quando viene avviato dall'utente.
  • classic_use_case_notebooklm_perform_source_discovery
    Scopri potenziali opzioni di fonti in base ai parametri di scoperta inseriti dall'utente.
  • classic_use_case_relevel_content
    Classroom: l'utente fa clic sul pulsante "Genera" nella pagina Uniforma il testo, che genera una versione aggiornata del testo specificato, appropriata per il livello scolastico inserito.
  • classic_use_case_sheets_turbofill
    Fogli: l'utente accetta un suggerimento proattivo per compilare una colonna con dati di testo in base a un'altra colonna della tabella.
  • classic_use_case_suggest_time_reporting
    Gmail: l'utente ha accettato un suggerimento generato da Gemini per un orario da proporre durante la pianificazione di una riunione utilizzando "Aiutami a pianificare" durante la composizione di un'email.
  • classic_use_case_teleprompter_word_match
    Vids: utilizzato per il suggeritore smart dello studio di registrazione, per abbinare le parole di uno script video al discorso di un utente in tempo reale utilizzando un modello di trascrizione vocale.
  • classic_use_case_translate_text
    Classroom: l'utente fa clic sul pulsante "Traduci" nella pagina Traduci testo, che traduce il testo inserito nella lingua selezionata.
  • condense
    • Gmail: abbrevia i contenuti della bozza quando l'utente fa clic su "Abbrevia" nel menu di perfezionamento.
    • Presentazioni: corrisponde al pulsante "Abbrevia" nel punto di accesso di Aiutami a scrivere sotto la casella di testo. Gemini restituisce una versione abbreviata della casella di testo selezionata.
  • conversation
    Un prompt viene inviato al riquadro laterale di Gemini. Questa operazione può essere avviata direttamente dall'utente o da un'altra funzionalità per conto dell'utente (ad esempio, un suggerimento on-grid).
  • custom_prompt
    Presentazioni: corrisponde all'input "Modifica con un prompt" nel punto di accesso di Aiutami a scrivere sotto la casella di testo. Gemini restituisce una versione riformulata della casella di testo selezionata in base al prompt dell'utente.
  • describe_gemini_uses
    • Chat: descrive gli utilizzi di Gemini nel contesto nel riquadro laterale.
    • Meet: "Cosa può fare Gemini in Google Meet" nel riquadro laterale.
    • Fogli: l'utente chiede a Gemini di descrivere le sue funzionalità o di suggerire modi per utilizzare la funzionalità.
  • elaborate
    Gmail: espande i contenuti della bozza quando l'utente fa clic su "Elabora" nel menu di perfezionamento.
  • formalize
    • Gmail: formalizza i contenuti della bozza quando l'utente fa clic su "Formalizza" nel menu di perfezionamento.
    • Presentazioni: corrisponde al pulsante "Più formale" nel punto di accesso di Aiutami a scrivere sotto la casella di testo. Gemini restituisce una versione riformulata della casella di testo selezionata con un tono più formale.
  • generate_ai_function_response
    Fogli: Gemini genera i contenuti direttamente in una cella o in un intervallo. Questo evento viene attivato quando un utente inserisce manualmente la funzione =AI() o utilizza una funzionalità che genera contenuti nella griglia per suo conto.
  • generate_avatar_video
    Vids: genera un video di un avatar digitale quando un utente fornisce uno script e fa clic su "Genera" nella barra laterale dell'avatar AI.
  • generate_document
    • Vids: genera un video di Google Vids in base a un prompt, a eventuali file allegati, a una struttura generata e a un modello supportato dalla finestra di dialogo Inizia.
    • Presentazioni: genera una presentazione Google in base a un prompt e alle fonti e agli stili forniti, dalla finestra di dialogo Per iniziare.
  • generate_form
    Moduli: genera un modulo in base al prompt dell'utente; viene attivato quando l'utente fa clic su "Crea" nella finestra di dialogo "Aiutami a creare". La finestra di dialogo è visibile quando crei un nuovo modulo o quando fai clic sul pulsante "Aiutami a creare".
  • generate_form_questions
    Moduli: genera più domande per il modulo esistente quando si fa clic sul pulsante "Suggerisci domande". Il pulsante viene visualizzato per i moduli non pubblicati, quando contengono già alcuni contenuti (titolo non predefinito e almeno due domande).
  • generate_image_for_current_page
    Presentazioni: generazione di immagini senza prompt per le slide. L'utente inserisce un prompt come "Suggerisci un'immagine per questa slide". Gemini genera prima il prompt dell'immagine, quindi lo utilizza per generare le immagini da restituire all'utente.
  • generate_images_in_product
    • Vids: genera un'immagine quando un utente inserisce un prompt testuale e fa clic su "Crea" nella barra laterale "Genera un'immagine".
    • Meet: si attiva dal riquadro laterale, l'utente inserisce un prompt testuale e fa clic sul pulsante "Crea esempi". Meet utilizzerà il prompt testuale inserito per generare alcune immagini che l'utente può utilizzare come immagine di sfondo visiva.
    • Presentazioni: l'utente fa clic sul punto di accesso "Aiutami a visualizzare" in Presentazioni; il modello per le immagini restituisce all'utente le immagini generate.
  • generate_nudge_prompts
    Fogli: Gemini suggerisce in modo proattivo funzionalità o prompt che l'utente può provare tramite suggerimenti sulla griglia.
  • generate_starter_active_view
    Gemini genera prompt iniziali suggeriti per gli utenti che utilizzano il contesto attivo.
  • generate_starter_freeform
    Genera una risposta quando si fa clic sui riquadri di partenza.
  • generate_starter_tile_prompts
    Gemini mostra i prompt iniziali, semi-contestuali, come riquadri nel riquadro laterale per aiutare gli utenti a iniziare.
  • generate_table_name
    Fogli: Gemini aggiunge automaticamente un nome alla tabella (in base ai contenuti della tabella) per una tabella appena convertita da un suggerimento di conversione della tabella.
  • generate_text
    Gmail: genera una bozza intelligente quando l'utente fa clic su "Crea" nell'input del prompt Aiutami a scrivere.
  • generate_videos_in_product
    Vids: genera un video quando un utente inserisce un prompt testuale nella barra laterale "Video clip AI".
  • live_generate_document
    Documenti: genera un documento dalla conversazione in tempo reale con l'utente.
  • outpaint
    Vids: genera una versione espansa di un'immagine selezionata, estendendola oltre i suoi bordi originali, quando un utente richiede l'outpainting nel prompt e fa clic su "Crea" nella barra laterale "Genera un'immagine".
  • paraphrase
    Presentazioni: corrisponde al pulsante "Riformula" nel punto di accesso di Aiutami a scrivere sotto la casella di testo. Gemini restituisce il testo selezionato riformulato in un altro modo.
  • proactive_daily_briefs
    Genera un riepilogo giornaliero proattivo per l'utente in Chat.
  • proactive_suggestions
    Genera testo per i riquadri dei suggerimenti proattivi in base al contesto.
  • proactive_suggestions_response
    L'utente ha selezionato un suggerimento proattivo da provare nel riquadro laterale di Gemini ed è stata generata una risposta.
  • proofread
  • remove_background
    Vids: rimuove lo sfondo da un'immagine selezionata, rendendolo trasparente, quando un utente fa clic sul pulsante "Rimuovi sfondo" nella barra degli strumenti mobile dell'immagine.
  • replace_background
    Vids: sostituisce lo sfondo di un'immagine selezionata quando un utente fornisce un prompt che descrive il nuovo sfondo e fa clic su "Crea" nella barra laterale "Genera un'immagine".
  • search_web
    L'utente ha cercato sul web utilizzando il riquadro laterale di Gemini.
  • suggest_time
    Calendar: hai richiesto suggerimenti sull'orario di una riunione.
  • summarize
    Gemini riassume il contesto attuale.
  • summarize_document_comment_thread
    Riassumere un thread di commenti in un documento.
  • summarize_drive_homepage_doclist_files
    Mostra un breve riepilogo del file in linea nell'elenco dei file della home page di Drive.
  • summarize_drive_homepage_doclist_files_long
    Mostra un riepilogo più lungo del file quando l'utente fa clic su "Visualizza dettagli" nell'elenco dei file della home page di Drive.
  • summarize_file
    Chat: genera un riepilogo di un file nel riquadro laterale della chat quando l'utente fa clic sul pulsante di riepilogo in una scheda di anteprima di un file di Drive nell'interfaccia utente della chat.
  • summarize_proactive
    Gemini genera e visualizza in modo proattivo un riepilogo dei contenuti attivi rilevati quando viene aperto il riquadro laterale.
  • summarize_proactive_short
    Gemini genera un breve riepilogo o titolo proattivo per i contenuti dell'utente.
  • user_confirmed_tools_operation
    L'utente fa clic sui pulsanti visualizzati nel riquadro laterale per confermare l'operazione durante una conversazione.
app_name

string

Nome dell'applicazione Workspace tramite la quale è stata eseguita l'azione. Valori possibili:

  • gemini_app
  • chat
  • classroom
  • docs
  • drive
  • gmail
  • keep
  • meet
  • notebooklm
    Gemini Notebook.
  • sheets
  • slides
  • vids
event_category

string

Il nome della categoria di evento indica il tipo di azione di AI generativa. Valori possibili:

  • active_conversations
    Rappresenta una conversazione con Gemini.
  • active_generate
    Rappresenta le funzionalità di generazione di Gemini, ad esempio: GENERATE_IMAGES o GENERATE_SLIDES.
  • active_summarize
    Rappresenta le funzionalità di riepilogo di Gemini, ad esempio SUMMARIZE_THREAD.
  • active_unspecified
    Rappresentano una categoria che non è né Genera né Riassumi.
  • inactive
    Rappresenta una categoria in cui l'utente non è considerato attivo su Gemini, ovvero non viene conteggiato ai fini dell'utilizzo attivo.
  • unknown
    Rappresenta una categoria non classificata.
feature_source

string

Identifica l'origine di un'interazione con l'AI generativa all'interno dell'interfaccia utente. Valori possibili:

  • ai_function
  • ask_gemini
    Chiedi a Gemini in Chat.
  • 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
Richiesta di esempio
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
Formato dei messaggi della Console di amministrazione
{actor} used Gen AI in {app_name}