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 2025-06-20T00:00:00Z. 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 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

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 una granularidad mínima a nivel de la oración. Proporciona sugerencias proactivas para mejorar la calidad del borrador.
  • bulletize
    Diapositivas: Corresponde al botón “Crear viñetas” en el punto de entrada de Ayúdame a escribir 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 ingresado.
  • 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" de la página Build a choice board, que genera una tabla de ejercicios de muestra para 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 Tackle common misconceptions, 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 Craft a compelling hook, que genera un ejercicio corto para estudiantes basado en el grado, la lección y los materiales de instrucción 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, lo que genera un texto que describe el tema ingresado y que es adecuado para el nivel de grado ingresado.
  • classic_use_case_generate_lesson_plan
    Classroom: El usuario hace clic en el botón "Generar plan de lecciones", que genera un plan de lecciones basado en el grado, el tema y los materiales de instrucción 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 Presentaciones basada en el grado, el tema y la duración de la presentación ingresados.
  • 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 de instrucción 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 ingresados.
  • classic_use_case_generate_rubric
    Classroom: El usuario hace clic en el botón "Generar criterios" en la página Crear una rúbrica, que genera una rúbrica de calificación basada en la calificación ingresada, 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" en la página Escribe un cuento, que genera un cuento corto basado en el grado, el tema y las palabras clave ingresados.
  • 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, que genera una lista de preguntas según el grado ingresado, el tipo de pregunta, las habilidades de lectura y la instrucción de texto.
  • classic_use_case_generate_vocab_list
    Classroom: El usuario hace clic en el botón "Generar" en la opción Crear una lista de vocabulario, que genera una lista de palabras y definiciones de vocabulario según el grado, el tema y los materiales de instrucción ingresados.
  • classic_use_case_meet_studio_lighting
    Meet: Mejora el video del usuario en condiciones de poca luz y permite que los usuarios usen fuentes de luz virtuales para tener un control más preciso.
  • classic_use_case_meet_studio_look
    Meet: Mejora 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" de la página Cambiar la complejidad del texto, 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 según 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 programó una reunión con "Ayúdame a programar" 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" en la página Traducir texto, lo 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.
    • Diapositivas: Corresponde al botón "Acortar" en el punto de entrada de Ayúdame a escribir debajo del 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 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
    Diapositivas: 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 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.
    • Diapositivas: Corresponde al botón “Más formal” 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 con un tono más formal.
    .
  • generate_ai_function_response
    Hojas de cálculo: Gemini genera contenido directamente en una celda o un rango. 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 del avatar de IA.
  • generate_document
    • Vids: Genera un video de Google basado en 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 basada en una instrucción y en 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 está visible cuando se crea un formulario nuevo o, de manera 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 tienen algo de contenido (título no predeterminado y un mínimo de 2 preguntas).
  • generate_image_for_current_page
    Presentaciones: Generación de imágenes sin instrucciones para diapositivas. El usuario ingresa una instrucción como "sugiere una imagen para esta diapositiva". Primero, Gemini genera la instrucción de imagen y, luego, la usa para generar imágenes que se le muestran 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 ingresada 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 generadas 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 iniciales 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 iniciales semi contextuales 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".
  • 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 expansión en su instrucción y hace clic en "Crear" en la barra lateral "Generar una imagen".
  • paraphrase
    Diapositivas: Corresponde al botón "Reformular" en el punto de entrada de Ayúdame a escribir debajo del cuadro de texto. Gemini devuelve el texto seleccionado reformulado de otra manera.
  • 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 el 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 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 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 del chat cuando el usuario hace clic en el botón de resumen en una tarjeta de vista previa de un archivo de Drive en la IU del chat.
  • summarize_proactive
    Cuando se abre el panel lateral, Gemini genera y muestra de forma proactiva un resumen del contenido activo detectado.
  • summarize_proactive_short
    Gemini genera un breve resumen o título 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

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 del evento indica el tipo de acción de la 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 no se considera que el usuario participa activamente en Gemini, es decir, no se contabiliza para el uso activo.
  • unknown
    Representa una categoría que no está clasificada.
feature_source

string

Identifica el origen de una interacción con 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 de los mensajes de la Consola del administrador
{actor} used Gen AI in {app_name}