Gemini in Workspace Apps Activity Events

In diesem Dokument werden die Ereignisse und Parameter für verschiedene Arten von Gemini in Workspace-Apps-Aktivitätsereignissen aufgeführt. Sie können diese Ereignisse abrufen, indem Sie Activities.list() mit applicationName=gemini_in_workspace_apps aufrufen.

Hinweis: Protokolle für „Gemini in Workspace-Apps“ sind ab dem 20.06.2025 um 00:00:00 Uhr UTC verfügbar. Ab diesem Datum wird ein fortlaufender Verlauf von bis zu 180 Tagen gespeichert.

Nutzungsereignis für Gemini in Workspace-Apps

Ereignistyp für nutzungsbezogene Ereignisse. Ereignisse dieses Typs werden mit type=ai_usage_event zurückgegeben.

Nutzung von generativer KI

Das Ereignis wird ausgelöst, wenn ein Nutzer eine Aktion ausführt, bei der Gemini in einer der Workspace-Apps verwendet wird.

Veranstaltungsdetails
Ereignisname feature_utilization
Parameter
action

string

Eine vom Nutzer in einer Workspace-Anwendung ausgeführte Aktion, die von Gemini initiiert oder unterstützt wurde. Mögliche Werte:

  • add_to_calendar
    Gmail: Der Nutzer hat mithilfe von Gemini einen Termin, der aus einer E‑Mail extrahiert wurde, seinem Kalender hinzugefügt.
  • auto_proofread
    Gmail: Anwendungsfall für das Optimieren eines Entwurfs im Text auf mindestens Satzebene. Es bietet proaktive Vorschläge zur Verbesserung der Entwurfsqualität.
  • bulletize
    Präsentationen: Entspricht der Schaltfläche „Stichpunkte“ im Einstiegspunkt „Formuliere für mich“ unter dem Textfeld. Gemini gibt den ausgewählten Text in Form einer Liste aus.
  • classic_use_case_convert_rubric
    Classroom: Der Nutzer klickt auf der Seite zum Erstellen von Aufgaben auf „+ Bewertungsschema“ und dann auf „Aus Datei konvertieren“. Dadurch wird ein Bewertungsschema basierend auf der eingegebenen Drive-Datei hochgeladen.
  • classic_use_case_generate_audio_lesson
    Classroom: Der Nutzer klickt auf den Button „Audiolektion erstellen“, um eine Audiolektion zu generieren, einschließlich einer Präsentation des Transkripts, basierend auf der eingegebenen Klassenstufe, dem Thema oder dem Inhalt.
  • classic_use_case_generate_choice_board
    Classroom: Der Nutzer klickt auf der Seite „Aufgabentafel erstellen“ auf den Button „Generieren“. Dadurch wird eine Tafel mit Beispielübungen für Schüler/Studenten erstellt, die auf der angegebenen Klassenstufe, dem Thema und den Unterrichtsmaterialien basieren.
  • classic_use_case_generate_common_misconceptions
    Classroom: Der Nutzer klickt auf der Seite „Häufige Missverständnisse ausräumen“ auf die Schaltfläche „Generieren“. Dadurch wird eine Liste mit häufigen Problemen generiert, mit denen Schüler und Studenten konfrontiert sind, basierend auf der eingegebenen Klassenstufe und dem Thema.
  • classic_use_case_generate_feedback
    Classroom: Der Nutzer klickt auf der Seite für die Benotung von Aufgaben auf „Formuliere für mich“. Dadurch wird ein Kommentar zur Abgabe des Schülers oder Studenten generiert, der auf der eingegebenen Note und dem Feedbackthema basiert.
  • classic_use_case_generate_hooks
    Classroom: Der Nutzer klickt auf der Seite „Einen fesselnden Einstieg erstellen“ auf den Button „Generieren“. Dadurch wird eine kurze Übung für Schüler/Studenten generiert, die auf der angegebenen Klassenstufe, der Lektion und den Unterrichtsmaterialien basiert.
  • classic_use_case_generate_informative_articles
    Classroom: Der Nutzer klickt auf der Seite „Informativen Text schreiben“ auf den Button „Generieren“. Dadurch wird ein Text generiert, der das eingegebene Thema beschreibt und für die eingegebene Klassenstufe geeignet ist.
  • classic_use_case_generate_lesson_plan
    Classroom: Der Nutzer klickt auf den Button „Kursplan erstellen“, um einen Kursplan basierend auf der eingegebenen Klassenstufe, dem Thema und den Unterrichtsmaterialien zu erstellen.
  • classic_use_case_generate_presentation
    Classroom: Der Nutzer klickt auf den Button „Präsentationsgliederung erstellen“, um eine Präsentation in Google Präsentationen zu erstellen. Dabei werden die Klassenstufe, das Thema und die Länge der Präsentation berücksichtigt.
  • classic_use_case_generate_project_activities
    Classroom: Der Nutzer klickt auf den Button „Projekt generieren“, um mehrere Ideen für Einzel- oder Gruppenprojekte zu generieren, die auf der eingegebenen Klassenstufe, dem Thema und den Unterrichtsmaterialien basieren.
  • classic_use_case_generate_questions
    Classroom: Der Nutzer klickt auf den Button „Fragen generieren“, wodurch eine Liste mit Fragen basierend auf der eingegebenen Klassenstufe, dem Thema und dem Fragetyp generiert wird.
  • classic_use_case_generate_rubric
    Classroom: Der Nutzer klickt auf der Seite „Bewertungsschema erstellen“ auf den Button „Kriterien generieren“. Dadurch wird ein Bewertungsschema basierend auf der eingegebenen Note, dem Leistungsniveau und der Aufgabenbeschreibung erstellt.
  • classic_use_case_generate_story
    Classroom: Der Nutzer klickt auf der Seite „Geschichte schreiben“ auf den Button „Generieren“. Dadurch wird eine Kurzgeschichte basierend auf der eingegebenen Klassenstufe, dem Thema und den Suchbegriffen generiert.
  • classic_use_case_generate_text_dependent_questions
    Classroom: Der Nutzer klickt auf der Seite „Verständnisfragen erstellen“ auf den Button „Fragen generieren“. Daraufhin wird eine Liste mit Fragen generiert, die auf der eingegebenen Klassenstufe, dem Fragetyp, den Lesefähigkeiten und dem Text-Prompt basiert.
  • classic_use_case_generate_vocab_list
    Classroom: Der Nutzer klickt auf der Seite „Vokabelliste erstellen“ auf den Button „Generieren“. Dadurch wird eine Liste mit Vokabeln und Definitionen erstellt, die auf der angegebenen Kursstufe, dem Thema und den Unterrichtsmaterialien basiert.
  • classic_use_case_meet_studio_lighting
    Meet: Verbessert die Videoqualität bei schlechten Lichtverhältnissen und ermöglicht die Verwendung virtueller Lichtquellen für eine genauere Steuerung.
  • classic_use_case_meet_studio_look
    Meet: Schärft die Gesichtszüge der Nutzer bei Bedarf.
  • classic_use_case_meet_studio_sound
    Meet: Verbessert bei Bedarf die Audioqualität. Insbesondere bei Verwendung eines Bluetooth-Schmalbandmikrofons.
  • classic_use_case_meet_take_notes_for_me_session
    Meet: Erstellt ein Dokument für Besprechungen, wenn die Funktion „Mach Notizen für mich“ verwendet wurde.
  • classic_use_case_notebooklm_generate_chat_response
    Generiert eine konversationelle Antwort auf eine Nutzeranfrage.
  • classic_use_case_notebooklm_generate_notebook_guide
    Erstellt eine Notebook-Anleitung basierend auf den vom Nutzer hochgeladenen Quellen.
  • classic_use_case_notebooklm_generate_source_guide
    Erstellt einen Quellleitfaden für eine bestimmte hochgeladene Quelle, wenn der Nutzer sie auswählt.
  • classic_use_case_notebooklm_generate_studio_artifact
    Generiert ein Studio-Artefakt basierend auf den Quellen des Nutzers, wenn der Nutzer dies initiiert.
  • classic_use_case_notebooklm_perform_source_discovery
    Sucht nach potenziellen Quelloptionen basierend auf den vom Nutzer eingegebenen Suchparametern.
  • classic_use_case_relevel_content
    Classroom: Der Nutzer klickt auf der Seite „Schwierigkeitsgrad des Textes ändern“ auf den Button „Generieren“. Dadurch wird eine aktualisierte Version des angegebenen Textes generiert, die für die eingegebene Kursstufe geeignet ist.
  • classic_use_case_sheets_turbofill
    Google Sheets: Ein Nutzer nimmt einen proaktiven Vorschlag an, um eine Spalte mit Textdaten basierend auf einer anderen Spalte in seiner Tabelle zu füllen.
  • classic_use_case_suggest_time_reporting
    Gmail: Der Nutzer hat einen von Gemini generierten Terminvorschlag angenommen, der beim Verfassen einer E‑Mail mit der Funktion „Plane für mich“ erstellt wurde.
  • classic_use_case_teleprompter_word_match
    Vids: Wird für den intelligenten Teleprompter im Aufnahmestudio verwendet, um Wörter aus einem Skript mithilfe eines Sprache-zu-Text-Modells in Echtzeit mit der Sprache eines Nutzers abzugleichen.
  • classic_use_case_translate_text
    Classroom: Der Nutzer klickt auf der Seite „Text übersetzen“ auf die Schaltfläche „Übersetzen“, um den eingegebenen Text in die ausgewählte Sprache zu übersetzen.
  • condense
    • Gmail: Kürzt den Inhalt des Entwurfs, wenn der Nutzer im Menü „Optimieren“ auf „Kürzen“ klickt.
    • Präsentationen: Entspricht der Schaltfläche „Kürzen“ im Einstiegspunkt „Formuliere für mich“ unter dem Textfeld. Gemini gibt eine gekürzte Version des ausgewählten Textfelds zurück.
    .
  • conversation
    Ein Prompt wird in der Gemini-Seitenleiste gesendet. Dies kann direkt vom Nutzer oder im Namen des Nutzers durch eine andere Funktion (z.B. einen Vorschlag im Raster) initiiert werden.
  • custom_prompt
    Präsentationen: Entspricht der Eingabe „Mit einem Prompt ändern“ im Einstiegspunkt „Formuliere für mich“ unter dem Textfeld. Gemini gibt eine umformulierte Version des ausgewählten Textfelds gemäß dem Prompt des Nutzers zurück.
  • describe_gemini_uses
    • Chat: Beschreibt die Verwendung von Gemini im Kontext in der Seitenleiste.
    • Meet: „Welche Funktionen bietet Gemini in Google Meet?“ in der Seitenleiste.
    • Google Sheets: Eine Person bittet Gemini, die Funktionen zu beschreiben oder Möglichkeiten zur Nutzung der Funktion vorzuschlagen.
    .
  • elaborate
    Gmail: Der Inhalt des Entwurfs wird erweitert, wenn der Nutzer im Menü „Optimieren“ auf „Ausführen“ klickt.
  • formalize
    • Gmail: Formuliert den Inhalt des Entwurfs formeller, wenn der Nutzer im Menü „Optimieren“ auf „Formeller ausdrücken“ klickt.
    • Präsentationen: Entspricht der Schaltfläche „Formeller“ im Einstiegspunkt „Formuliere für mich“ unter dem Textfeld. Gemini gibt eine umformulierte Version des ausgewählten Textfelds zurück, die formeller ist.
    .
  • generate_ai_function_response
    Google Sheets: Gemini generiert Inhalte direkt in einer Zelle oder einem Bereich. Dies wird ausgelöst, wenn ein Nutzer die Funktion „=AI()“ manuell eingibt oder eine Funktion verwendet, die in seinem Namen Inhalte im Raster generiert.
  • generate_avatar_video
    Vids: Erstellt ein Video mit einem digitalen Avatar, wenn ein Nutzer ein Skript eingibt und in der Seitenleiste für KI-Avatare auf „Generieren“ klickt.
  • generate_document
    • Vids: Generiert ein Google-Video basierend auf einem Prompt, angehängten Dateien, einer generierten Gliederung und einer unterstützten Vorlage aus dem Dialogfeld „Erste Schritte“.
    • Präsentationen: Generiert im Dialogfeld „Erste Schritte“ eine Google-Präsentation basierend auf einem Prompt und allen bereitgestellten Quellen und Stilen.
    .
  • generate_form
    Formulare: Generiert ein Formular basierend auf dem Prompt des Nutzers. Wird ausgelöst, wenn der Nutzer im Dialogfeld „Erstelle für mich“ auf „Erstellen“ klickt. Das Dialogfeld wird angezeigt, wenn ein neues Formular erstellt wird oder wenn der Nutzer auf den Button „Erstelle für mich“ klickt.
  • generate_form_questions
    Formulare: Wenn Sie auf die Schaltfläche „Fragen vorschlagen“ klicken, werden weitere Fragen für das vorhandene Formular generiert. Die Schaltfläche wird für nicht veröffentlichte Formulare angezeigt, wenn sie bereits Inhalte enthalten (nicht standardmäßiger Titel und mindestens zwei Fragen).
  • generate_image_for_current_page
    Präsentationen: Bildgenerierung ohne Prompt für Folien. Der Nutzer gibt einen Prompt wie „Schlage ein Bild für diese Folie vor“ ein. Gemini generiert zuerst den Bild-Prompt und verwendet ihn dann, um Bilder zu generieren, die an den Nutzer zurückgegeben werden.
  • generate_images_in_product
    • Vids: Generiert ein Bild, wenn ein Nutzer einen Text-Prompt eingibt und in der Seitenleiste „Bild generieren“ auf „Erstellen“ klickt.
    • Meet: Wird über die Seitenleiste ausgelöst. Der Nutzer gibt einen Text-Prompt ein und klickt auf „Beispiele erstellen“. Meet verwendet den eingegebenen Text-Prompt, um einige Bilder zu generieren, die der Nutzer als virtuellen Hintergrund verwenden kann.
    • Präsentationen: Der Nutzer klickt in Präsentationen auf den Einstiegspunkt „Visualisiere für mich“. Das Modell zur Bilderstellung gibt die generierten Bilder an den Nutzer zurück.
    .
  • generate_nudge_prompts
    Google Sheets: Gemini schlägt proaktive Vorschläge für Funktionen oder Prompts vor, die der Nutzer über Vorschläge im Raster ausprobieren kann.
  • generate_starter_active_view
    Gemini generiert vorgeschlagene Einstiegsprompts für Nutzer, die den aktiven Kontext nutzen.
  • generate_starter_freeform
    Generiert eine Antwort, wenn auf Starter-Tiles geklickt wird.
  • generate_starter_tile_prompts
    Gemini zeigt Nutzern in der Seitenleiste erste, halbkontextbezogene Einstiegsprompts als Kacheln an, um ihnen den Einstieg zu erleichtern.
  • generate_table_name
    Google Sheets: Gemini fügt einer neu konvertierten Tabelle automatisch einen Tabellennamen (basierend auf dem Tabelleninhalt) hinzu, wenn ein Vorschlag zur Tabellenkonvertierung angenommen wird.
  • generate_text
    Gmail: Generiert einen intelligenten Entwurf, wenn der Nutzer im Prompt „Formuliere für mich“ auf „Erstellen“ klickt.
  • generate_videos_in_product
    Vids: Generiert ein Video, wenn ein Nutzer einen Text-Prompt in die Seitenleiste „KI-Videoclip“ eingibt.
  • live_generate_document
    Docs: Dokument aus einer Live-Unterhaltung mit einem Nutzer erstellen.
  • outpaint
    Vids: Generiert eine erweiterte Version eines ausgewählten Bildes, die über die ursprünglichen Grenzen hinausgeht, wenn ein Nutzer in seinem Prompt Outpainting anfordert und in der Seitenleiste „Bild generieren“ auf „Erstellen“ klickt.
  • paraphrase
    Präsentationen: Entspricht der Schaltfläche „Umformulieren“ im Einstiegspunkt „Formuliere für mich“ unter dem Textfeld. Gemini gibt den ausgewählten Text in einer anderen Formulierung zurück.
  • proactive_daily_briefs
    Erstellt für den Nutzer in Google Chat eine proaktive Tagesübersicht.
  • proactive_suggestions
    Generiert Text für Kacheln mit proaktiven Vorschlägen basierend auf dem Kontext.
  • proactive_suggestions_response
    Der Nutzer hat einen proaktiven Vorschlag ausgewählt, um ihn in der Gemini-Seitenleiste auszuprobieren, und es wurde eine Antwort generiert.
  • proofread
  • remove_background
    Vids: Entfernt den Hintergrund eines ausgewählten Bildes und macht ihn transparent, wenn ein Nutzer in der unverankerten Symbolleiste des Bildes auf die Schaltfläche „Hintergrund entfernen“ klickt.
  • replace_background
    Vids: Ersetzt den Hintergrund eines ausgewählten Bildes, wenn ein Nutzer einen Prompt eingibt, der den neuen Hintergrund beschreibt, und in der Seitenleiste „Bild generieren“ auf „Erstellen“ klickt.
  • search_web
    Der Nutzer hat über die Gemini-Seitenleiste im Web gesucht.
  • suggest_time
    Kalender: Zeitvorschläge für eine Besprechung angefordert.
  • summarize
    Gemini fasst den aktuellen Kontext zusammen.
  • summarize_document_comment_thread
    Kommentar-Thread in einem Dokument zusammenfassen
  • summarize_drive_homepage_doclist_files
    Zeigt eine kurze Dateizusammenfassung direkt in der Dateiliste auf der Google Drive-Startseite an.
  • summarize_drive_homepage_doclist_files_long
    Zeigt eine längere Dateizusammenfassung an, wenn der Nutzer in der Dateiliste auf der Google Drive-Startseite auf „Details ansehen“ klickt.
  • summarize_file
    Chat: Erstellt eine Zusammenfassung einer Datei in der Seitenleiste des Chats, wenn der Nutzer auf der Vorschaukarte einer Drive-Datei in der Chat-Benutzeroberfläche auf die Schaltfläche „Zusammenfassen“ klickt.
  • summarize_proactive
    Gemini generiert und zeigt proaktiv eine Zusammenfassung der erkannten aktiven Inhalte an, wenn die Seitenleiste geöffnet wird.
  • summarize_proactive_short
    Gemini erstellt eine kurze proaktive Zusammenfassung oder einen Titel für die Inhalte des Nutzers.
  • user_confirmed_tools_operation
    Der Nutzer klickt auf die Schaltflächen, die in der Seitenleiste angezeigt werden, um den Vorgang während einer Unterhaltung zu bestätigen.
app_name

string

Name der Workspace-Anwendung, über die die Aktion ausgeführt wurde. Mögliche Werte:

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

string

Der Name der Ereigniskategorie gibt den Typ der generativen KI-Aktion an. Mögliche Werte:

  • active_conversations
    Stellt eine Unterhaltung mit Gemini dar.
  • active_generate
    Repräsentiert die Generierungsfunktionen von Gemini, z. B. GENERATE_IMAGES oder GENERATE_SLIDES.
  • active_summarize
    Stellt die Zusammenfassungsfunktionen von Gemini dar, z. B. SUMMARIZE_THREAD.
  • active_unspecified
    Stellt eine Kategorie dar, die weder „Generieren“ noch „Zusammenfassen“ ist.
  • inactive
    Stellt eine Kategorie dar, in der der Nutzer nicht als aktiv mit Gemini interagierend gilt, d. h. die Nutzung wird nicht auf die aktive Nutzung angerechnet.
  • unknown
    Stellt eine Kategorie dar, die nicht klassifiziert ist.
feature_source

string

Gibt an, wo eine Interaktion mit generativer KI in der Benutzeroberfläche ausgelöst wurde. Mögliche Werte:

  • ai_function
  • ask_gemini
    Gemini in Google Chat fragen
  • 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
Beispielanfrage
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
Nachrichtenformat in der Admin-Konsole
{actor} used Gen AI in {app_name}