Gemini in Workspace Apps Activity Events

In diesem Dokument werden die Ereignisse und Parameter für verschiedene Arten von Aktivitätsereignissen für Gemini in Workspace-Apps 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 GMT verfügbar. Ab diesem Datum wird ein fortlaufender Verlauf von bis zu 180 Tagen geführt.

Gemini in Workspace-Apps: Nutzungsereignis

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 mit Gemini einen Termin, der aus seiner E‑Mail extrahiert wurde, seinem Kalender hinzugefügt.
  • auto_proofread
    Gmail: Anwendungsfall für das Überarbeiten eines Entwurfs inline mit einer Mindestgranularität auf Satzebene. Sie erhalten proaktive Vorschläge zur Verbesserung der Qualität von Entwürfen.
  • bulletize
    Google-Präsentationen: Entspricht der Schaltfläche „In Stichpunkte umwandeln“ im Eingabefeld „Formuliere für mich“. Gemini gibt den ausgewählten Text in Form einer Liste zurück.
  • classic_use_case_convert_rubric
    Classroom: Der Nutzer klickt auf der Seite zum Erstellen von Aufgaben auf „+ Rubrik“ und dann auf „Aus Datei konvertieren“. Dadurch wird eine Bewertungsrubrik basierend auf der eingegebenen Drive-Datei hochgeladen.
  • classic_use_case_generate_audio_lesson
    Classroom: Der Nutzer klickt auf die Schaltfläche „Audiolektion erstellen“. Daraufhin wird basierend auf der eingegebenen Klassenstufe, dem Thema oder den Inhalten eine Audiolektion erstellt, die auch eine Präsentation des Transkripts in Google Präsentationen enthält.
  • classic_use_case_generate_choice_board
    Classroom: Der Nutzer klickt auf der Seite „Choice Board erstellen“ auf die Schaltfläche „Generieren“. Daraufhin wird ein Choice Board mit Beispielaufgaben für Schüler/Studenten basierend auf der eingegebenen Klassenstufe, dem Thema und den Lehrmaterialien generiert.
  • classic_use_case_generate_common_misconceptions
    Classroom: Der Nutzer klickt auf der Seite „Häufige Missverständnisse angehen“ auf die Schaltfläche „Generieren“. Daraufhin wird anhand der eingegebenen Klassenstufe und des Themas eine Liste mit häufigen Problemen erstellt, mit denen Schüler/Studenten konfrontiert sind.
  • classic_use_case_generate_feedback
    Classroom: Der Nutzer klickt auf der Seite zum Benoten von Aufgaben auf „Formuliere für mich“. Daraufhin wird basierend auf der eingegebenen Note und dem Feedbackthema ein Kommentar zur Einsendung des Schülers oder Studenten generiert.
  • classic_use_case_generate_hooks
    Classroom: Der Nutzer klickt auf der Seite „Einen ansprechenden Einstieg erstellen“ auf die Schaltfläche „Generieren“. Dadurch wird eine kurze Übung für Schüler/Studenten basierend auf der eingegebenen Klassenstufe, Lektion und den Lehrmaterialien generiert.
  • classic_use_case_generate_informative_articles
    Classroom: Der Nutzer klickt auf der Seite „Informativen Text schreiben“ auf die Schaltfläche „Generieren“. Dadurch wird 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“. Daraufhin wird ein Kursplan auf Grundlage der eingegebenen Klassenstufe, des Themas und der Unterrichtsmaterialien erstellt.
  • classic_use_case_generate_presentation
    Classroom: Der Nutzer klickt auf die Schaltfläche „Präsentationsübersicht erstellen“. Daraufhin wird eine Google-Präsentation basierend auf der eingegebenen Klassenstufe, dem Thema und der Präsentationslänge erstellt.
  • classic_use_case_generate_project_activities
    Classroom: Der Nutzer klickt auf die Schaltfläche „Projekt generieren“. Daraufhin werden basierend auf der eingegebenen Klassenstufe, dem Thema und den Lehrmaterialien mehrere Ideen für Einzel- oder Gruppenprojekte generiert.
  • classic_use_case_generate_questions
    Classroom: Der Nutzer klickt auf die Schaltfläche „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 die Schaltfläche „Kriterien generieren“. Dadurch wird ein Bewertungsschema basierend auf der eingegebenen Note, der Leistungsstufe und den Aufgabenanweisungen generiert.
  • classic_use_case_generate_story
    Classroom: Der Nutzer klickt auf der Seite „Geschichte schreiben“ auf die Schaltfläche „Generieren“. Dadurch wird eine Kurzgeschichte basierend auf der eingegebenen Klassenstufe, dem Thema und den Stichwörtern generiert.
  • classic_use_case_generate_text_dependent_questions
    Classroom: Der Nutzer klickt auf der Seite „Fragen zum Leseverständnis erstellen“ auf die Schaltfläche „Fragen generieren“. Daraufhin wird eine Liste mit Fragen generiert, die auf der eingegebenen Klassenstufe, dem Fragetyp, den Lesekompetenzen und dem Text-Prompt basiert.
  • classic_use_case_generate_vocab_list
    Classroom: Der Nutzer klickt auf die Schaltfläche „Generieren“ unter „Vokabelliste erstellen“. Daraufhin wird eine Liste mit Vokabeln und Definitionen basierend auf der eingegebenen Klassenstufe, dem Thema und den Unterrichtsmaterialien generiert.
  • classic_use_case_meet_studio_lighting
    Meet: Das Video des Nutzers wird bei schlechten Lichtverhältnissen verbessert. Außerdem können Nutzer virtuelle Lichtquellen verwenden, um die Beleuchtung genauer zu steuern.
  • classic_use_case_meet_studio_look
    Meet: Schärft die Nutzerfunktionen bei Bedarf.
  • classic_use_case_meet_studio_sound
    Meet: Verbessert bei Bedarf die Audioqualität. Dies gilt insbesondere bei Verwendung eines Bluetooth-Mikrofons mit schmalbandiger Übertragung.
  • 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_relevel_content
    Classroom: Der Nutzer klickt auf der Seite „Schwierigkeitsgrad des Textes ändern“ auf die Schaltfläche „Generieren“. Dadurch wird eine aktualisierte Version des angegebenen Textes generiert, die für die eingegebene Klassenstufe geeignet ist.
  • classic_use_case_sheets_turbofill
    Sheets: Der Nutzer akzeptiert einen proaktiven Vorschlag, 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 Vorschlag für einen Termin angenommen, der beim Planen einer Besprechung mit „Hilfe beim Planen“ während des Verfassens einer E‑Mail angeboten wurde.
  • classic_use_case_teleprompter_word_match
    Google Vids: Wird für den Smart-Teleprompter im Aufnahmestudio verwendet, um Wörter aus einem Skript mithilfe eines Speech-to-Text-Modells in Echtzeit an die Sprache eines Nutzers anzupassen.
  • 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ü zur Optimierung auf „Kürzen“ klickt.
    • Präsentationen: Entspricht der Schaltfläche „Kürzen“ im Eingabefeld für „Formuliere für mich“. Gemini gibt eine gekürzte Version des ausgewählten Textfelds zurück.
    .
  • conversation
    Ein Prompt wird an die Gemini-Seitenleiste gesendet. Dies kann direkt vom Nutzer oder von einer anderen Funktion im Namen des Nutzers initiiert werden, z.B. durch einen Vorschlag im Raster.
  • custom_prompt
    Google-Präsentationen: Entspricht der Eingabe „Mit einem Prompt bearbeiten“ im Eingabefeld „Formuliere für mich“ unter dem Textfeld. Gemini gibt eine umformulierte Version des ausgewählten Textfelds entsprechend 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.
    • Sheets: Der Nutzer bittet Gemini, die Funktionen zu beschreiben oder Nutzungsmöglichkeiten vorzuschlagen.
    .
  • elaborate
    Gmail: Der Inhalt des Entwurfs wird erweitert, wenn der Nutzer im Menü „Verfeinern“ auf „Ausführlicher“ klickt.
  • formalize
    • Gmail: Der Inhalt des Vorschlags wird formalisiert, wenn der Nutzer im Menü zur Optimierung auf „Formalisieren“ klickt.
    • Google-Präsentationen: Entspricht der Schaltfläche „Formeller“ im Eingabefeld für „Formuliere für mich“. Gemini gibt eine umformulierte Version des ausgewählten Textfelds zurück, die einen formelleren Ton hat.
    .
  • generate_ai_function_response
    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 Tabellenblatt generiert.
  • generate_avatar_video
    Vids: Erstellt ein Video eines digitalen Avatars, 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, allen angehängten Dateien, einem generierten Konzept und einer unterstützten Vorlage aus dem Dialogfeld „Erste Schritte“.
    • Präsentationen: Erstellt eine Google-Präsentation basierend auf einem Prompt und allen bereitgestellten Quellen und Stilen über das Dialogfeld „Erste Schritte“.
    .
  • generate_form
    Formulare: Generiert ein Formular basierend auf dem Nutzer-Prompt. Wird ausgelöst, wenn der Nutzer im Dialogfeld „Erstelle für mich“ auf „Erstellen“ klickt. Das Dialogfeld wird beim Erstellen eines neuen Formulars oder beim Klicken auf die Schaltfläche „Erstelle für mich“ angezeigt.
  • generate_form_questions
    Formulare: Wenn auf die Schaltfläche „Fragen vorschlagen“ geklickt wird, werden für das vorhandene Formular weitere Fragen generiert. Die Schaltfläche wird für unveröffentlichte Formulare angezeigt, wenn sie bereits einige Inhalte haben (mindestens zwei Fragen und ein Titel, der nicht der Standardtitel ist).
  • generate_image_for_current_page
    Google Präsentationen: Bildgenerierung ohne Prompt für Folien. Der Nutzer gibt einen Prompt ein, z. B. „Schlage ein Bild für diese Folie vor“. Gemini generiert zuerst den Bild-Prompt und verwendet ihn dann, um Bilder zu generieren, die dem Nutzer zurückgegeben werden.
  • generate_images_in_product
    • Google Vids: Generiert ein Bild, wenn ein Nutzer einen Text-Prompt eingibt und in der Seitenleiste „Bild generieren“ auf „Erstellen“ klickt.
    • Meet: Auslöser über die Seitenleiste. Der Nutzer gibt einen Textprompt ein und klickt auf die Schaltfläche „Beispiele erstellen“. Meet verwendet den eingegebenen Textprompt, um einige Bilder zu generieren, die der Nutzer als visuellen Hintergrund verwenden kann.
    • Präsentationen: Der Nutzer klickt in Präsentationen auf den Einstiegspunkt „Visualisiere für mich“. Das Bildmodell gibt die generierten Bilder an den Nutzer zurück.
    .
  • generate_nudge_prompts
    Sheets: Gemini schlägt dem Nutzer proaktiv Funktionen oder Prompts vor, die er über Vorschläge im Tabellenbereich ausprobieren kann.
  • generate_starter_active_view
    Gemini generiert Vorschläge für Startprompts für Nutzer, die den aktiven Kontext nutzen.
  • generate_starter_freeform
    Generiert eine Antwort, wenn auf Starterkacheln geklickt wird.
  • generate_starter_tile_prompts
    Gemini zeigt in der Seitenleiste erste, halbkontextbezogene Starter-Prompts als Kacheln an, um Nutzern den Einstieg zu erleichtern.
  • generate_table_name
    Sheets: Gemini fügt automatisch einen Tabellennamen (basierend auf dem Tabelleninhalt) für eine neu konvertierte Tabelle aus einem Vorschlag zur Tabellenkonvertierung hinzu.
  • generate_text
    Gmail: Generiert einen intelligenten Entwurf, wenn der Nutzer auf „Erstellen“ klickt, nachdem er einen Prompt für „Formuliere für mich“ eingegeben hat.
  • generate_videos_in_product
    Vids: Erstellt ein Video, wenn ein Nutzer in der Seitenleiste „KI-Videoclip“ einen Text-Prompt eingibt.
  • outpaint
    Google 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
    Google-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_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: Wenn ein Nutzer in der schwebenden Symbolleiste für Bilder auf die Schaltfläche „Hintergrund entfernen“ klickt, wird der Hintergrund des ausgewählten Bildes entfernt und transparent gemacht.
  • replace_background
    Vids: Ersetzt den Hintergrund für ein ausgewähltes Bild, wenn ein Nutzer einen Prompt mit einer Beschreibung des neuen Hintergrunds eingibt und in der Seitenleiste „Bild generieren“ auf „Erstellen“ klickt.
  • search_web
    Nutzer hat mit der Gemini-Seitenleiste im Web gesucht.
  • suggest_time
    Google Kalender: Vorschläge für die angeforderte Zeit für eine Besprechung.
  • 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 inline 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 Chat-Seitenleiste, wenn der Nutzer in der Chat-Benutzeroberfläche auf der Vorschaukarte einer Drive-Datei 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 in der Seitenleiste auf Schaltflächen, 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
  • 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
    Steht für die Funktionen von Gemini zur Generierung von Elementen, 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 generiert noch zusammengefasst wird.
  • inactive
    Stellt eine Kategorie dar, in der der Nutzer nicht als aktiv mit Gemini interagierend gilt. Diese Kategorie wird nicht auf die aktive Nutzung angerechnet.
  • unknown
    Stellt eine Kategorie dar, die nicht klassifiziert ist.
feature_source

string

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

  • 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
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}