Gemini in Workspace Apps Activity Events

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

Nota: i log di "Gemini nelle app Workspace" saranno disponibili a partire dal 2025-06-20T00:00:00Z. A partire da questa data, verrà mantenuta una cronologia mobile di un massimo di 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 un evento estratto dalla sua email al calendario utilizzando Gemini.
  • auto_proofread
    Gmail: caso d'uso per la correzione di 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 "Elenca puntato" nel punto di accesso Aiutami a scrivere sotto la casella di testo. Gemini restituisce il testo selezionato organizzato in punti elenco.
  • classic_use_case_convert_rubric
    Classroom: l'utente fa clic su "+ Griglia di valutazione", poi 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 di input.
  • classic_use_case_generate_choice_board
    Classroom: l'utente fa clic sul pulsante "Genera" nella pagina Crea una choice board, che genera una tabella di esercizi di esempio per gli studenti in base al livello, all'argomento e ai materiali didattici di input.
  • classic_use_case_generate_common_misconceptions
    Classroom: l'utente fa clic sul pulsante "Genera" nella pagina Affronta i malintesi comuni, che genera un elenco di problemi comuni che gli studenti devono affrontare, in base al livello e all'argomento di input.
  • classic_use_case_generate_feedback
    Classroom: l'utente fa clic su "Aiutami a scrivere" nella pagina di valutazione del compito, che genera un commento sul compito dello studente, in base al livello e all'argomento del feedback di input.
  • classic_use_case_generate_hooks
    Classroom: l'utente fa clic sul pulsante "Genera" nella pagina Crea un incipit accattivante, che genera un breve esercizio per gli studenti, in base al livello, alla lezione e ai materiali didattici di input.
  • 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 di input.
  • 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 di input.
  • classic_use_case_generate_project_activities
    Classroom: l'utente fa clic sul pulsante "Genera progetto", che genera diverse idee di progetto individuali o di gruppo, in base al livello, all'argomento e ai materiali didattici di input.
  • 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 di input.
  • classic_use_case_generate_rubric
    Classroom: l'utente fa clic sul pulsante "Genera criteri" nella pagina Crea una griglia di valutazione, che genera una griglia di valutazione in base al livello, al livello di rendimento e alle istruzioni del compito di input.
  • 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 al livello, all'argomento e alle parole chiave di input.
  • 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 capacità di lettura e al prompt testuale di input.
  • classic_use_case_generate_vocab_list
    Classroom: l'utente fa clic sul pulsante "Genera" nella pagina Crea un elenco di vocaboli, che genera un elenco di vocaboli e definizioni, in base al livello, all'argomento e ai materiali didattici di input.
  • classic_use_case_meet_studio_lighting
    Meet: migliora il video dell'utente in condizioni di illuminazione scarsa e consente agli utenti di utilizzare sorgenti di luce virtuali per un controllo più preciso.
  • classic_use_case_meet_studio_look
    Meet: nitida le funzionalità dell'utente quando necessario.
  • classic_use_case_meet_studio_sound
    Meet: migliora la qualità audio quando necessario. In particolare quando si utilizza un microfono a banda stretta Bluetooth.
  • 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, appropriata per il livello di input.
  • classic_use_case_sheets_turbofill
    Fogli: l'utente accetta un suggerimento proattivo per popolare 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 offrire 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 uno script al discorso di un utente in tempo reale utilizzando un modello di conversione da voce a testo.
  • classic_use_case_translate_text
    Classroom: l'utente fa clic sul pulsante "Traduci" nella pagina Traduci testo, che traduce il testo di input 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 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 avviato direttamente dall'utente o da un'altra funzionalità per conto dell'utente (ad es. un suggerimento nella griglia).
  • custom_prompt
    Presentazioni: 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 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 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. Questa operazione viene attivata 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 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 set di Presentazioni Google in base a un prompt e a eventuali origini 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 altre domande per il modulo esistente quando si fa clic sul pulsante "Suggerisci domande"; il pulsante viene visualizzato per i moduli non pubblicati, quando hanno già alcuni contenuti (titolo non predefinito e almeno 2 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: si attiva dal riquadro laterale, l'utente inserisce un prompt testuale e fa clic sul pulsante "Crea esempi"; Meet utilizzerà il prompt testuale di input 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" nelle slide; il modello di immagine restituisce le immagini generate all'utente.
    .
  • generate_nudge_prompts
    Fogli: Gemini suggerisce in modo proattivo funzionalità o prompt da provare all'utente tramite un suggerimento nella griglia.
  • generate_starter_active_view
    Gemini genera prompt di partenza 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 di partenza iniziali e semi-contestuali come riquadri nel riquadro laterale per aiutare gli utenti a iniziare.
  • generate_table_name
    Fogli: Gemini aggiunge automaticamente un nome di 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, che si estende oltre i 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_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 di orario richiesti per una riunione.
  • summarize
    Gemini riassume il contesto attuale.
  • summarize_document_comment_thread
    Riassumi una sequenza 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 su una scheda di anteprima del 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

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

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

string

Il nome della categoria di eventi 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
    Rappresenta una categoria che non è né di generazione né di riepilogo.
  • inactive
    Rappresenta una categoria in cui l'utente non è considerato attivo su Gemini; non viene conteggiata 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
  • 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 del messaggio della Console di amministrazione
{actor} used Gen AI in {app_name}