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: Ein 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 dem Button „In Stichpunkte umwandeln“ im Eingabefeld für „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 „+ 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 die Schaltfläche „Audiolektion erstellen“. Daraufhin wird basierend auf der eingegebenen Klassenstufe, dem Thema oder den Inhalten eine Audiolektion erstellt, einschließlich einer Google-Präsentation des Transkripts.
  • classic_use_case_generate_choice_board
    Classroom: Der Nutzer klickt auf der Seite „Aufgabentafel erstellen“ auf den Button „Generieren“. Daraufhin wird eine Tafel mit Beispielübungen für Schüler auf Grundlage der eingegebenen Klassenstufe, des Themas und der Unterrichtsmaterialien erstellt.
  • 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 zur Benotung von Aufgaben auf „Formuliere für mich“. Daraufhin wird basierend auf der eingegebenen Note und dem Feedbackthema ein Kommentar zur Einreichung des Schülers oder Studenten generiert.
  • classic_use_case_generate_hooks
    Classroom: Der Nutzer klickt auf der Seite „Einen ansprechenden Einstieg erstellen“ auf den Button „Generieren“. Dadurch wird eine kurze Übung für Lernende basierend auf der eingegebenen Klassenstufe, Lektion und den Unterrichtsmaterialien 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 den Button „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 erstellen“, wodurch basierend auf der eingegebenen Klassenstufe, dem Thema und den Unterrichtsmaterialien mehrere Ideen für Einzel- oder Gruppenprojekte generiert werden.
  • 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 den Button „Kriterien generieren“. Daraufhin 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 den Button „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 entwickeln“ 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 „Generieren“ unter „Vokabelliste erstellen“. Daraufhin wird eine Liste mit Vokabeln und Definitionen basierend auf der eingegebenen Kursstufe, 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 Sprachü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 „Plane für mich“ während des Verfassens einer E‑Mail angeboten wurde.
  • classic_use_case_teleprompter_word_match
    Google Vids: Wird für den intelligenten 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 den Button „Ü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.
    • Folien: Entspricht dem Button „Kürzen“ im Eingabefeld „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 für „Formuliere für mich“. 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: Erweitert den Inhalt des Entwurfs, wenn der Nutzer im Menü „Verfeinern“ auf „Ausführlicher“ klickt.
  • formalize
    • Gmail: Der Inhalt des Entwurfs wird formalisiert, wenn der Nutzer im Menü zur Optimierung auf „Formeller ausdrücken“ klickt.
    • Google-Präsentationen: Entspricht dem Button „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
    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 Tabellengitter generiert.
  • generate_avatar_video
    Vids: Generiert 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 auf Grundlage eines Prompts sowie aller bereitgestellten Quellen und Stile ü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 angezeigt, wenn ein neues Formular erstellt wird oder wenn der Nutzer auf den Button „Erstelle für mich“ klickt.
  • generate_form_questions
    Formulare: Wenn auf die Schaltfläche „Fragen vorschlagen“ geklickt wird, werden mehr Fragen für das vorhandene Formular 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 dem Standardtitel entspricht).
  • generate_image_for_current_page
    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 Text-Prompt ein und klickt auf die Schaltfläche „Beispiele erstellen“. Meet verwendet den eingegebenen Text-Prompt, um einige Bilder zu generieren, die der Nutzer als visuellen Hintergrund verwenden kann.
    • Google Präsentationen: Der Nutzer klickt in Google 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 erste, halbkontextbezogene Starter-Prompts als Kacheln in der Seitenleiste 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: Wenn der Nutzer auf „Erstellen“ in der Eingabeaufforderung „Formuliere für mich“ klickt, wird ein intelligenter Entwurf generiert.
  • generate_videos_in_product
    Vids: Generiert ein Video, wenn ein Nutzer in der Seitenleiste „KI-Videoclip“ einen Text-Prompt eingibt.
  • live_generate_document
    Docs: Dokument aus Live-Unterhaltung mit Nutzer erstellen.
  • outpaint
    Vids: Erstellt 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 dem Button „Formuliere um“ im Eingabefeld „Formuliere für mich“. Gemini gibt den ausgewählten Text in einer anderen Formulierung zurück.
  • proactive_daily_briefs
    Generiert eine proaktive Tagesübersicht für den Nutzer in Chat.
  • proactive_suggestions
    Generiert Text für proaktive Vorschlagskacheln 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: Der Hintergrund eines ausgewählten Bildes wird entfernt und transparent gemacht, wenn ein Nutzer in der schwebenden Symbolleiste des Bildes auf die Schaltfläche „Hintergrund entfernen“ klickt.
  • 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
    Der Nutzer hat mit der Gemini-Seitenleiste im Web gesucht.
  • suggest_time
    Google Kalender: Zeitvorschläge für eine Besprechung anfordern
  • 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 einer Vorschaukarte für eine Drive-Datei auf die Schaltfläche „Zusammenfassen“ klickt.
  • summarize_proactive
    Wenn die Seitenleiste geöffnet wird, generiert und zeigt Gemini proaktiv eine Zusammenfassung der erkannten aktiven Inhalte an.
  • 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 die angezeigten 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

„Event Category Name“ (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 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 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 nicht klassifizierte Kategorie dar.
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
  • 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}