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 di valutazione", poi su "Converti da file" nella pagina di creazione del compito, che carica una griglia di valutazione basata sul 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 scheda di scelta, che genera una scheda 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 dei 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 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 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 della classe, 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 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 di valutazione, 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 grado di istruzione, al tipo di domanda, alle competenze di lettura e al prompt di testo 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 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. Fogli: l'utente chiede a Gemini di descrivere le sue funzionalità o 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 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 crei 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 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 di testo e fa clic su "Crea" nella barra laterale "Genera un'immagine". Meet: i trigger vengono attivati dal riquadro laterale, l'utente inserisce il prompt di testo e fa clic sul pulsante "Crea campioni". Meet utilizzerà il prompt di testo inserito per generare alcune immagini che l'utente potrà utilizzare come immagine di sfondo visiva. 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 Sheets: Gemini suggerisce in modo proattivo funzionalità o prompt da provare per l'utente tramite il suggerimento 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 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 di testo nella barra laterale "Clip video AI". 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 Slide: 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_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 effettuato ricerche 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 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 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 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. 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 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}