Gemini in Workspace Apps Activity Events

En este documento, se enumeran los eventos y los parámetros de varios tipos de eventos de actividad de Gemini en las apps de Workspace. Para recuperar estos eventos, llama a Activities.list() con applicationName=gemini_in_workspace_apps.

Nota: Los registros de "Gemini en las apps de Workspace" estarán disponibles a partir del 20 de junio de 2025 a las 00:00:00 UTC. A partir de esta fecha, se mantendrá un historial continuo de hasta 180 días.

Evento de utilización de Gemini en las apps de Workspace

Es el tipo de evento para los eventos relacionados con el uso. Los eventos de este tipo se muestran con type=ai_usage_event.

Uso de la IA generativa

El evento se activa cuando un usuario realiza una acción que usa Gemini en cualquiera de las apps de Workspace.

Detalles del evento
Nombre del evento feature_utilization
Parámetros
action

string

La acción que realiza el usuario en una aplicación de Workspace, iniciada o asistida por Gemini. Valores posibles:

  • add_to_calendar
    Gmail: El usuario agregó un evento extraído de su correo electrónico a su calendario con Gemini.
  • auto_proofread
    Gmail: Caso de uso para corregir un borrador intercalado con una granularidad mínima a nivel de la oración. Proporciona sugerencias proactivas para mejorar la calidad del borrador.
  • bulletize
    Presentaciones: Corresponde al botón "Crear lista" en el punto de entrada Ayúdame a escribir en el cuadro de texto. Gemini devuelve el texto seleccionado organizado en viñetas.
  • classic_use_case_convert_rubric
    Classroom: El usuario hace clic en "+Rúbrica" y, luego, en "Convertir desde un archivo" en la página de creación de tareas, que sube una rúbrica de calificación basada en el archivo de Drive de entrada.
  • classic_use_case_generate_audio_lesson
    Classroom: El usuario hace clic en el botón "Generar lección de audio", que genera una lección de audio, incluida una presentación de Presentaciones de la transcripción, basada en el grado, el tema o el contenido de entrada.
  • classic_use_case_generate_choice_board
    Classroom: El usuario hace clic en el botón "Generar" en la página Crear un tablero de opciones, que genera un tablero de ejercicios de muestra para estudiantes basado en el grado, el tema y los materiales didácticos de entrada.
  • classic_use_case_generate_common_misconceptions
    Classroom: El usuario hace clic en el botón "Generar" en la página Aborda las ideas equivocadas comunes, que genera una lista de problemas comunes que enfrentan los estudiantes, basada en el grado y el tema de entrada.
  • classic_use_case_generate_feedback
    Classroom: El usuario hace clic en "Ayúdame a escribir" en la página de calificación de tareas, que genera un comentario sobre la entrega del estudiante, basado en el grado y el tema de comentarios de entrada.
  • classic_use_case_generate_hooks
    Classroom: El usuario hace clic en el botón "Generar" en la página Crea contenido atractivo que capte la atención, que genera un ejercicio corto para estudiantes, basado en el grado, la lección y los materiales didácticos de entrada.
  • classic_use_case_generate_informative_articles
    Classroom: El usuario hace clic en el botón "Generar" en la página Escribe un texto informativo, que genera texto que describe el tema de entrada, adecuado para el nivel de grado de entrada.
  • classic_use_case_generate_lesson_plan
    Classroom: El usuario hace clic en el botón "Generar plan de la lección", que genera un plan de la lección basado en el grado, el tema y los materiales didácticos de entrada.
  • classic_use_case_generate_presentation
    Classroom: El usuario hace clic en el botón "Generar esquema de presentación", que genera una presentación de Presentaciones, basada en el grado, el tema y la duración de la presentación de entrada.
  • classic_use_case_generate_project_activities
    Classroom: El usuario hace clic en el botón "Generar proyecto", que genera varias ideas de proyectos individuales o grupales, basadas en el grado, el tema y los materiales didácticos de entrada.
  • classic_use_case_generate_questions
    Classroom: El usuario hace clic en el botón "Generar preguntas", que genera una lista de preguntas, basada en el grado, el tema y el tipo de pregunta de entrada.
  • classic_use_case_generate_rubric
    Classroom: El usuario hace clic en el botón "Generar criterios" en la página Crea una rúbrica, que genera una rúbrica de calificación basada en el grado, el nivel de rendimiento y las instrucciones de la tarea de entrada.
  • classic_use_case_generate_story
    Classroom: El usuario hace clic en el botón "Generar" en la página Escribe una historia, que genera una historia corta, basada en el grado, el tema y las palabras clave de entrada.
  • classic_use_case_generate_text_dependent_questions
    Classroom: El usuario hace clic en el botón "Generar preguntas" en la página Desarrolla preguntas de comprensión de lectura, que genera una lista de preguntas, basada en el grado, el tipo de pregunta, las habilidades de lectura y la instrucción de texto de entrada.
  • classic_use_case_generate_vocab_list
    Classroom: El usuario hace clic en el botón "Generar" en la página Crea una lista de vocabulario, que genera una lista de palabras de vocabulario y definiciones, basada en el grado, el tema y los materiales didácticos de entrada.
  • classic_use_case_meet_studio_lighting
    Meet: Mejora el video del usuario en condiciones de poca luz y permite a los usuarios usar fuentes de luz virtuales para un control más preciso.
  • classic_use_case_meet_studio_look
    Meet: Define las funciones del usuario cuando es necesario.
  • classic_use_case_meet_studio_sound
    Meet: Mejora la calidad del audio cuando es necesario. En particular, cuando se usa un micrófono de banda estrecha Bluetooth.
  • classic_use_case_meet_take_notes_for_me_session
    Meet: Genera un documento para las reuniones cuando se usó la función Toma notas por mí.
  • classic_use_case_relevel_content
    Classroom: El usuario hace clic en el botón "Generar" en la página Cambia la complejidad de los textos, que genera una versión actualizada del texto especificado, adecuada para el grado de entrada.
  • classic_use_case_sheets_turbofill
    Hojas de cálculo: El usuario acepta una sugerencia proactiva para completar una columna con datos de texto basados en otra columna de su tabla.
  • classic_use_case_suggest_time_reporting
    Gmail: El usuario aceptó una sugerencia generada por Gemini para ofrecer una hora cuando programa una reunión con "Ayúdame a programar una reunión" mientras redacta un correo electrónico.
  • classic_use_case_teleprompter_word_match
    Vids: Se usa para el teleprónter inteligente del estudio de grabación, para hacer coincidir palabras de una secuencia de comandos con el discurso de un usuario en tiempo real mediante un modelo de voz a texto.
  • classic_use_case_translate_text
    Classroom: El usuario hace clic en el botón "Traducir" en la página Traduce texto, que traduce el texto de entrada al idioma seleccionado.
  • condense
    • Gmail: Acorta el contenido del borrador cuando el usuario hace clic en "Acortar" en el menú de refinamiento.
    • Presentaciones: Corresponde al botón "Acortar" en el punto de entrada Ayúdame a escribir en el cuadro de texto. Gemini devuelve una versión abreviada del cuadro de texto seleccionado.
    .
  • conversation
    Se envía una instrucción al panel lateral de Gemini. El usuario puede iniciarla directamente o a través de otra función en su nombre (p.ej., una sugerencia en la cuadrícula).
  • custom_prompt
    Presentaciones: Corresponde a la entrada "Modificar con una instrucción" en el punto de entrada Ayúdame a escribir en el cuadro de texto. Gemini devuelve una versión reformulada del cuadro de texto seleccionado según la instrucción del usuario.
  • describe_gemini_uses
    • Chat: Describe los usos de Gemini en contexto en el panel lateral.
    • Meet: "¿Qué puede hacer Gemini en Google Meet?" en el panel lateral.
    • Hojas de cálculo: El usuario le pide a Gemini que describa sus capacidades o que sugiera formas de usar la función.
    .
  • elaborate
    Gmail: Expande el contenido del borrador cuando el usuario hace clic en "Desarrollar" en el menú de refinamiento.
  • formalize
    • Gmail: Formaliza el contenido del borrador cuando el usuario hace clic en "Formalizar" en el menú de refinamiento.
    • Presentaciones: Corresponde al botón "Más formal" en el punto de entrada Ayúdame a escribir en el cuadro de texto. Gemini devuelve una versión reformulada del cuadro de texto seleccionado que tiene un tono más formal.
    .
  • generate_ai_function_response
    Hojas de cálculo: Gemini genera contenido directamente en una celda o un rango. Esto se activa cuando un usuario ingresa manualmente la función =AI() o usa una función que genera contenido en la cuadrícula en su nombre.
  • generate_avatar_video
    Vids: Genera un video de un avatar digital cuando un usuario proporciona una secuencia de comandos y hace clic en "Generar" en la barra lateral del avatar de IA.
  • generate_document
    • Vids: Genera un video de Google basado en una instrucción, cualquier archivo adjunto, un esquema generado y una plantilla compatible del diálogo Primeros pasos.
    • Presentaciones: Genera un conjunto de diapositivas de Google basado en una instrucción y cualquier fuente y estilo proporcionados, desde el diálogo Primeros pasos.
    .
  • generate_form
    Formularios: Genera un formulario basado en la instrucción del usuario; se activa cuando el usuario hace clic en "Crear" en el diálogo "Ayúdame a crear". El diálogo está visible cuando se crea un formulario nuevo o, de forma alternativa, cuando el usuario hace clic en el botón "Ayúdame a crear".
  • generate_form_questions
    Formularios: Genera más preguntas para el formulario existente cuando se hace clic en el botón "Sugerir preguntas"; el botón se muestra para los formularios no publicados, cuando ya tiene algo de contenido (título no predeterminado y 2 preguntas como mínimo).
  • generate_image_for_current_page
    Presentaciones: Generación de imágenes sin instrucciones para las diapositivas. El usuario ingresa una instrucción como "sugerir una imagen para esta diapositiva". Primero, Gemini genera la instrucción de imagen y, luego, la usa para generar imágenes que se devuelven al usuario.
  • generate_images_in_product
    • Vids: Genera una imagen cuando un usuario ingresa una instrucción de texto y hace clic en "Crear" en la barra lateral "Generar una imagen".
    • Meet: Se activa desde el panel lateral. El usuario ingresa una instrucción de texto y hace clic en el botón "Crear muestras". Meet usará la instrucción de texto de entrada para generar algunas imágenes que el usuario puede usar como imagen de fondo visual.
    • Presentaciones: El usuario hace clic en el punto de entrada "Ayúdame a visualizar" en Presentaciones. El modelo de imagen devuelve las imágenes generadas al usuario.
    .
  • generate_nudge_prompts
    Hojas de cálculo: Gemini sugiere de forma proactiva funciones o instrucciones para que el usuario pruebe a través de la sugerencia en la cuadrícula.
  • generate_starter_active_view
    Gemini genera instrucciones iniciales sugeridas para los usuarios que utilizan el contexto activo.
  • generate_starter_freeform
    Genera una respuesta cuando se hace clic en los mosaicos iniciales.
  • generate_starter_tile_prompts
    Gemini muestra instrucciones iniciales semi contextuales como mosaicos en el panel lateral para ayudar a los usuarios a comenzar.
  • generate_table_name
    Hojas de cálculo: Gemini agrega automáticamente un nombre de tabla (basado en el contenido de la tabla) para una tabla recién convertida a partir de una sugerencia de conversión de tabla.
  • generate_text
    Gmail: Genera un borrador inteligente cuando el usuario hace clic en "Crear" en la entrada de la instrucción Ayúdame a escribir.
  • generate_videos_in_product
    Vids: Genera un video cuando un usuario ingresa una instrucción de texto en la barra lateral "Clip de video de IA".
  • live_generate_document
    Documentos: Genera un documento a partir de una conversación en vivo con el usuario.
  • outpaint
    Vids: Genera una versión expandida de una imagen seleccionada, que se extiende más allá de sus bordes originales, cuando un usuario solicita la extensión de imagen en su instrucción y hace clic en "Crear" en la barra lateral "Generar una imagen".
  • paraphrase
    Presentaciones: Corresponde al botón "Parafrasear" en el punto de entrada Ayúdame a escribir en el cuadro de texto. Gemini devuelve el texto seleccionado reformulado de otra forma.
  • proactive_suggestions
    Genera texto para los mosaicos de sugerencias proactivas según el contexto.
  • proactive_suggestions_response
    El usuario seleccionó una sugerencia proactiva para probar en el panel lateral de Gemini y se generó una respuesta.
  • proofread
  • remove_background
    Vids: Quita el fondo de una imagen seleccionada, lo que la hace transparente, cuando un usuario hace clic en el botón "Quitar fondo" en la barra de herramientas flotante de la imagen.
  • replace_background
    Vids: Reemplaza el fondo de una imagen seleccionada cuando un usuario proporciona una instrucción que describe el nuevo fondo y hace clic en "Crear" en la barra lateral "Generar una imagen".
  • search_web
    El usuario buscó en la Web con el panel lateral de Gemini.
  • suggest_time
    Calendario: Sugerencias de horarios solicitadas para una reunión.
  • summarize
    Gemini resume el contexto actual.
  • summarize_document_comment_thread
    Resume un hilo de comentarios en un documento.
  • summarize_drive_homepage_doclist_files
    Muestra un breve resumen del archivo intercalado en la lista de archivos de la página principal de Drive.
  • summarize_drive_homepage_doclist_files_long
    Muestra un resumen más largo del archivo cuando el usuario hace clic en "Ver detalles" en la lista de archivos de la página principal de Drive.
  • summarize_file
    Chat: Genera un resumen de un archivo en el panel lateral de chat cuando el usuario hace clic en el botón de resumen en una tarjeta de vista previa de archivo de Drive en la IU de chat.
  • summarize_proactive
    Gemini genera y muestra de forma proactiva un resumen del contenido activo detectado cuando se abre el panel lateral.
  • summarize_proactive_short
    Gemini genera un resumen o título proactivo breve para el contenido del usuario.
  • user_confirmed_tools_operation
    El usuario hace clic en los botones que aparecen en el panel lateral para confirmar la operación durante una conversación.
app_name

string

Es el nombre de la aplicación de Workspace a través de la cual se realizó la acción. Valores posibles:

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

string

El nombre de la categoría de eventos indica el tipo de acción de IA generativa. Valores posibles:

  • active_conversations
    Representa una conversación con Gemini.
  • active_generate
    Representa las capacidades de generación de Gemini. Ejemplo: GENERATE_IMAGES o GENERATE_SLIDES.
  • active_summarize
    Representa las capacidades de resumen de Gemini. Ejemplo: SUMMARIZE_THREAD.
  • active_unspecified
    Representa una categoría que no es generar ni resumir.
  • inactive
    Representa una categoría en la que no se considera que el usuario interactúa de forma activa con Gemini; es decir, no se cuenta para el uso activo.
  • unknown
    Representa una categoría que no está clasificada.
feature_source

string

Identifica dónde se origina una interacción de IA generativa dentro de la interfaz de usuario. Valores posibles:

  • 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
Solicitud de muestra
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 mensaje de la Consola del administrador
{actor} used Gen AI in {app_name}