Gemini in Workspace Apps Activity Events

Questo documento elenca gli eventi e i parametri per 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/2025 alle ore 00:00 UTC. A partire da questa data, verrà mantenuta una cronologia mobile fino a 180 giorni.

Evento di utilizzo di Gemini nelle app Workspace

Tipo di evento per gli eventi correlati 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 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 sua 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à delle bozze.
  • bulletize
    Presentazioni: corrisponde al pulsante "Elenco puntato" nel punto di accesso 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", poi su "Converti da file" nella pagina di creazione del compito, che carica una griglia di valutazione in base al file di Drive inserito.
  • 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 grado, 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 voto e all'argomento inseriti.
  • classic_use_case_generate_feedback
    Classroom: l'utente fa clic su "Aiutami a scrivere" nella pagina di valutazione del compito, che genera un commento sull'invio dello 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 aggancio accattivante, che genera un breve esercizio per gli studenti in base al grado, 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 inserito.
  • 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 scolastico, 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 Google in base al livello, all'argomento e alla durata della presentazione inseriti.
  • classic_use_case_generate_project_activities
    Classroom: l'utente fa clic sul pulsante "Genera progetto", che genera diverse idee per 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 grado, 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 inserito, al livello di rendimento e alle istruzioni del compito.
  • classic_use_case_generate_story
    Classroom: l'utente fa clic sul pulsante "Genera" nella pagina Scrivi una storia, che genera un racconto breve in base al grado, 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 di istruzione, 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 parole di vocabolario e definizioni in base al grado, 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 fonti di luce virtuali per un controllo più preciso.
  • classic_use_case_meet_studio_look
    Meet: migliora le funzionalità per gli utenti 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_relevel_content
    Classroom: l'utente fa clic sul pulsante "Genera" nella pagina Uniforma il testo, che genera una versione aggiornata del testo specificato, adatta al 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 intelligente dello studio di registrazione, per abbinare le parole di un copione al discorso di un utente in tempo reale utilizzando un modello di sintesi 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. Può essere avviata direttamente dall'utente o da un'altra funzionalità per suo conto (ad es. un suggerimento sulla griglia).
  • custom_prompt
    Slide: corrisponde all'input "Modifica con un prompt" nel punto di accesso 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 del riquadro laterale.
    • Meet: "Cosa può fare Gemini in Google Meet" nel riquadro laterale.
    • Sheets: l'utente chiede a Gemini di descrivere le sue funzionalità o suggerisce 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 contenuti direttamente in una cella o in un intervallo. Si attiva 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 un copione e fa clic su "Genera" nella barra laterale dell'avatar AI.
  • generate_document
    • Vids: genera un video di Google in base a un prompt, a eventuali file allegati, a una struttura generata e a un modello supportato dalla finestra di dialogo Guida introduttiva.
    • Presentazioni: genera un file di Presentazioni Google basato su un prompt e su eventuali fonti e stili forniti dalla finestra di dialogo Guida introduttiva.
  • 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 si crea un nuovo modulo o, in alternativa, quando l'utente fa clic sul pulsante "Aiutami a creare".
  • generate_form_questions
    Moduli: genera più domande per il modulo esistente quando viene fatto clic sul pulsante "Suggerisci domande"; il pulsante viene visualizzato per i moduli non pubblicati, quando hanno 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, poi 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: i trigger vengono attivati dal riquadro laterale, l'utente inserisce il prompt testuale e fa clic sul pulsante "Crea campioni". Meet utilizzerà il prompt testuale inserito per generare alcune immagini che l'utente potrà utilizzare come immagine di sfondo.
    • Presentazioni: l'utente fa clic sul punto di accesso "Aiutami a visualizzare" nelle slide; il modello di immagini restituisce le immagini generate all'utente.
  • generate_nudge_prompts
    Fogli: Gemini suggerisce in modo proattivo funzionalità o prompt da provare per l'utente tramite suggerimenti nella 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 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) per una tabella appena convertita da un suggerimento di conversione.
  • 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, che si estende 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 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, rendendola 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: Suggerimenti per l'orario richiesto per una riunione.
  • summarize
    Gemini riassume il contesto attuale.
  • summarize_document_comment_thread
    Riassumi 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 "Mostra 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 mostra in modo proattivo un riepilogo dei contenuti attivi rilevati all'apertura del 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

Il nome dell'applicazione Workspace tramite cui è stata eseguita l'azione. Valori possibili:

  • gemini_app
  • chat
  • classroom
  • docs
  • drive
  • gmail
  • keep
  • meet
  • sheets
  • slides
  • vids
event_category

string

Nome categoria 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. Esempio: GENERATE_IMAGES o GENERATE_SLIDES.
  • active_summarize
    Rappresenta le funzionalità di riepilogo di Gemini. Esempio: SUMMARIZE_THREAD.
  • active_unspecified
    Rappresenta una categoria che non è né genera né riepiloga.
  • inactive
    Rappresenta una categoria in cui l'utente non è considerato attivo su Gemini, pertanto non viene conteggiato ai fini dell'utilizzo attivo.
  • unknown
    Rappresenta una categoria non classificata.
feature_source

string

Identifica l'origine di un'interazione di 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
  • 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}