Gemini in Workspace Apps Activity Events

En este documento, se enumeran los eventos y parámetros de varios tipos de eventos de actividad de Gemini en las apps de Workspace. Puedes recuperar estos eventos llamando 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:00Z. A partir de esa fecha, se mantendrá un historial continuo de hasta 180 días.

Evento de uso 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 devuelven 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

Es 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ó a su calendario un evento extraído de su correo electrónico con Gemini.
  • auto_proofread
    Gmail: Caso de uso para pulir un borrador intercalado con un nivel de detalle mínimo de oración. Proporciona sugerencias proactivas para mejorar la calidad de los borradores.
  • bulletize
    Presentaciones: Corresponde al botón "Crear viñetas" en el punto de entrada de Ayúdame a escribir que se encuentra debajo del 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, lo 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 diapositivas de la transcripción, según el grado, el tema o el contenido ingresados.
  • classic_use_case_generate_choice_board
    Classroom: El usuario hace clic en el botón "Generar" en la página Crea un tablero de opciones, lo que genera un tablero de ejercicios de muestra para los estudiantes según el grado, el tema y los materiales didácticos ingresados.
  • classic_use_case_generate_common_misconceptions
    Classroom: El usuario hace clic en el botón "Generar" de la página Aborda las ideas erróneas comunes, que genera una lista de problemas comunes que enfrentan los estudiantes, según el grado y el tema ingresados.
  • classic_use_case_generate_feedback
    Classroom: El usuario hace clic en "Ayúdame a escribir" en la página de calificación de la tarea, lo que genera un comentario sobre la entrega del estudiante, según la calificación ingresada y el tema de los comentarios.
  • classic_use_case_generate_hooks
    Classroom: El usuario hace clic en el botón "Generar" en la página Crea un gancho atractivo, que genera un ejercicio breve para los estudiantes, según el grado, la lección y los materiales didácticos ingresados.
  • 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 un texto que describe el tema de entrada, apropiado 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 según el grado, el tema y los materiales didácticos ingresados.
  • 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 diapositivas basada en el grado, el tema y la duración de la presentación que se ingresaron.
  • 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, según el grado, el tema y los materiales didácticos ingresados.
  • classic_use_case_generate_questions
    Classroom: El usuario hace clic en el botón "Generar preguntas", que genera una lista de preguntas según el grado, el tema y el tipo de pregunta que se ingresaron.
  • classic_use_case_generate_rubric
    Classroom: El usuario hace clic en el botón "Generar criterios" en la página Crear una rúbrica, lo que genera una rúbrica de calificación basada en la calificación de entrada, el nivel de rendimiento y las instrucciones de la tarea.
  • classic_use_case_generate_story
    Classroom: El usuario hace clic en el botón "Generar" de la página Escribir un cuento, que genera un cuento breve según el grado, el tema y las palabras clave que se ingresaron.
  • classic_use_case_generate_text_dependent_questions
    Classroom: El usuario hace clic en el botón "Generar preguntas" en la página Desarrollar preguntas de comprensión lectora, lo que genera una lista de preguntas basadas en el grado, el tipo de pregunta, las habilidades de lectura y la instrucción de texto que se ingresaron.
  • classic_use_case_generate_vocab_list
    Classroom: El usuario hace clic en el botón "Generar" en la opción para crear una lista de vocabulario, lo que genera una lista de palabras y definiciones de vocabulario según el grado, el tema y los materiales didácticos ingresados.
  • classic_use_case_meet_studio_lighting
    Meet: Mejora el video del usuario en condiciones de poca iluminación y le permite usar fuentes de luz virtuales para un control más detallado.
  • classic_use_case_meet_studio_look
    Meet: Enfoca los rasgos 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 Bluetooth de banda estrecha.
  • 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_notebooklm_generate_chat_response
    Genera una respuesta conversacional a la consulta de un usuario.
  • classic_use_case_notebooklm_generate_notebook_guide
    Genera una guía de cuaderno basada en las fuentes que subió el usuario.
  • classic_use_case_notebooklm_generate_source_guide
    Genera una guía de fuentes para una fuente específica subida cuando el usuario la selecciona.
  • classic_use_case_notebooklm_generate_studio_artifact
    Genera un artefacto de Studio basado en las fuentes del usuario cuando este lo inicia.
  • classic_use_case_notebooklm_perform_source_discovery
    Descubre posibles opciones de fuentes según los parámetros de descubrimiento que ingresa el usuario.
  • classic_use_case_relevel_content
    Classroom: El usuario hace clic en el botón "Generar" de la página Cambiar la complejidad de los textos, lo que genera una versión actualizada del texto especificado, apropiada para el grado ingresado.
  • 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 un horario cuando programaba una reunión con "Ayúdame a programar una reunión" mientras redactaba 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 las palabras de un guion con el discurso de un usuario en tiempo real con un modelo de voz a texto.
  • classic_use_case_translate_text
    Classroom: El usuario hace clic en el botón "Traducir" de la página Traducir 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 perfeccionamiento.
    • Presentaciones: Corresponde al botón "Acortar" en el punto de entrada de Ayúdame a escribir que se encuentra debajo del cuadro de texto. Gemini devuelve una versión resumida del cuadro de texto seleccionado.
    .
  • conversation
    Se envía una instrucción al panel lateral de Gemini. El usuario puede iniciar esta acción 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 de Ayúdame a escribir debajo del 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 "Elaborar" en el menú de perfeccionamiento.
  • formalize
    • Gmail: Formaliza el contenido del borrador cuando el usuario hace clic en "Formalizar" en el menú de perfeccionamiento.
    • Presentaciones: Corresponde al botón "Más formal" en el punto de entrada de Ayúdame a escribir que se encuentra debajo del cuadro de texto. Gemini devuelve una versión reformulada del cuadro de texto seleccionado con 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 un guion y hace clic en "Generar" en la barra lateral de avatares de IA.
  • generate_document
    • Vids: Genera un video de Google Vids en función de una instrucción, los archivos adjuntos, un esquema generado y una plantilla compatible del diálogo de introducción.
    • Presentaciones: Genera una presentación de Google Slides a partir de una instrucción y de las fuentes y los estilos proporcionados, desde el diálogo de introducción.
    .
  • generate_form
    Formularios: Genera un formulario según 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 se muestra cuando se crea un formulario nuevo o 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 "sugiere una imagen para esta diapositiva". Gemini primero 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 imágenes devuelve las imágenes creadas con tecnología generativa al usuario.
    .
  • generate_nudge_prompts
    Hojas de cálculo: Gemini sugiere de forma proactiva funciones o instrucciones para que el usuario las pruebe a través de sugerencias en la cuadrícula.
  • generate_starter_active_view
    Gemini genera instrucciones de inicio sugeridas para los usuarios que utilizan el contexto activo.
  • generate_starter_freeform
    Genera una respuesta cuando se hace clic en las tarjetas de inicio.
  • generate_starter_tile_prompts
    Gemini muestra instrucciones de inicio iniciales y semicontextuales como tarjetas 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 (según 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 con 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 una 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 "Reescribir" en el punto de entrada de Ayúdame a escribir que se encuentra debajo del cuadro de texto. Gemini devuelve el texto seleccionado reformulado de otra manera.
  • proactive_daily_briefs
    Genera un resumen diario proactivo para el usuario en Chat.
  • proactive_suggestions
    Genera texto para las tarjetas 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 y lo hace transparente cuando un usuario hace clic en el botón "Quitar fondo" de 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 fondo nuevo y hace clic en "Crear" en la barra lateral "Generar una imagen".
  • search_web
    El usuario realizó una búsqueda en la Web con el panel lateral de Gemini.
  • suggest_time
    Calendario: Sugerencias de horarios solicitados para una reunión.
  • summarize
    Gemini resume el contexto actual.
  • summarize_document_comment_thread
    Resumir un hilo de comentarios en un documento
  • summarize_drive_homepage_doclist_files
    Muestra un breve resumen de un 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 para resumir en una tarjeta de vista previa de un 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 breve y proactivo 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
  • notebooklm
    Gemini Notebook.
  • sheets
  • slides
  • vids
event_category

string

El nombre de la categoría del evento 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, por ejemplo, GENERATE_IMAGES o GENERATE_SLIDES.
  • active_summarize
    Representa las capacidades de resumen de Gemini, p. ej., SUMMARIZE_THREAD.
  • active_unspecified
    Representa una categoría que no es de generación ni de resumen.
  • inactive
    Representa una categoría en la que se considera que el usuario no interactúa activamente con Gemini, es decir, que no se incluye en 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
  • ask_gemini
    Pregúntale a Gemini en Chat.
  • 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
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 de los mensajes de la Consola del administrador
{actor} used Gen AI in {app_name}