Gemini in Workspace Apps Activity Events

Este documento lista os eventos e parâmetros para vários tipos de eventos de atividade do Gemini nos apps do Workspace. Você pode recuperar esses eventos chamando Activities.list() com applicationName=gemini_in_workspace_apps.

Observação: os registros do Gemini nos apps do Workspace vão estar disponíveis a partir de 20 de junho de 2025. A partir dessa data, um histórico contínuo de até 180 dias será mantido.

Evento de utilização do Gemini nos apps do Workspace

Tipo de evento para eventos relacionados ao uso. Os eventos desse tipo são retornados com type=ai_usage_event.

Uso da IA generativa

O evento é acionado quando um usuário realiza uma ação que usa o Gemini em qualquer um dos apps do Workspace.

Detalhes do evento
Nome do evento	feature_utilization
Parâmetros	action string Ação realizada pelo usuário em um aplicativo do Workspace, iniciada ou assistida pelo Gemini. Valores possíveis: add_to_calendar Gmail: o usuário adicionou um evento extraído do e-mail à agenda usando o Gemini. auto_proofread Gmail: caso de uso para revisar um rascunho inline com granularidade mínima de frase. Ele oferece sugestões proativas para melhorar a qualidade do rascunho. bulletize Apresentações: corresponde ao botão "Criar marcadores" no ponto de entrada "Me ajude a escrever" na caixa de texto. O Gemini retorna o texto selecionado organizado em marcadores. classic_use_case_convert_rubric Sala de Aula: o usuário clica em "+Rubrica" e depois em "Converter do arquivo" na página de criação de atividades, que faz o upload de uma rubrica de classificação com base no arquivo do Drive de entrada. classic_use_case_generate_audio_lesson Sala de Aula: o usuário clica no botão "Gerar aula em áudio", que gera uma aula em áudio, incluindo uma apresentação do Slides da transcrição, com base na série, no tema ou no conteúdo de entrada. classic_use_case_generate_choice_board Sala de Aula: o usuário clica no botão "Gerar" na página "Criar um quadro de opções", que gera um quadro de exercícios de estudantes de exemplo com base na série, no tema e nos materiais didáticos de entrada. classic_use_case_generate_common_misconceptions Sala de Aula: o usuário clica no botão "Gerar" na página "Abordar equívocos comuns", que gera uma lista de problemas comuns que os estudantes enfrentam, com base na série e no tema de entrada. classic_use_case_generate_feedback Sala de Aula: o usuário clica em "Me ajude a escrever" na página de classificação de atividades, que gera um comentário sobre a atividade do estudante, com base na série e no tema do feedback. classic_use_case_generate_hooks Sala de Aula: o usuário clica no botão "Gerar" na página "Crie um gancho interessante", que gera um exercício curto para estudantes, com base na série, na lição e nos materiais didáticos de entrada. classic_use_case_generate_informative_articles Sala de Aula: o usuário clica no botão "Gerar" na página "Escreva um texto informativo", que gera um texto que descreve o tema de entrada, adequado para o nível de escolaridade de entrada. classic_use_case_generate_lesson_plan Sala de Aula: o usuário clica no botão "Gerar plano de aula", que gera um plano de aula com base na série, no tema e nos materiais didáticos de entrada. classic_use_case_generate_presentation Sala de Aula: o usuário clica no botão "Gerar estrutura da apresentação", que gera uma apresentação do Slides com base na série, no tema e na duração da apresentação de entrada. classic_use_case_generate_project_activities Sala de Aula: o usuário clica no botão "Gerar projeto", que gera várias ideias de projetos individuais ou em grupo, com base na série, no tema e nos materiais didáticos de entrada. classic_use_case_generate_questions Sala de Aula: o usuário clica no botão "Gerar perguntas", que gera uma lista de perguntas com base na série, no tema e no tipo de pergunta de entrada. classic_use_case_generate_rubric Sala de Aula: o usuário clica no botão "Gerar critérios" na página "Criar uma rubrica", que gera uma rubrica de classificação com base na série, no nível de desempenho e nas instruções da atividade de entrada. classic_use_case_generate_story Sala de Aula: o usuário clica no botão "Gerar" na página "Escreva uma história", que gera uma história curta com base na série, no tema e nas palavras-chave de entrada. classic_use_case_generate_text_dependent_questions Sala de Aula: o usuário clica no botão "Gerar perguntas" na página "Desenvolver perguntas de compreensão de leitura", que gera uma lista de perguntas com base na série, no tipo de pergunta, nas habilidades de leitura e no comando de texto de entrada. classic_use_case_generate_vocab_list Sala de Aula: o usuário clica no botão "Gerar" na página "Criar uma lista de vocabulário", que gera uma lista de palavras e definições de vocabulário com base na série, no tema e nos materiais didáticos de entrada. classic_use_case_meet_studio_lighting Meet: melhora o vídeo do usuário em condições de iluminação ruins e permite que os usuários usem fontes de luz virtuais para um controle mais refinado. classic_use_case_meet_studio_look Meet: aprimora os recursos do usuário quando necessário. classic_use_case_meet_studio_sound Meet: melhora a qualidade do áudio quando necessário. Principalmente ao usar um microfone de banda estreita Bluetooth. classic_use_case_meet_take_notes_for_me_session Meet: gera um documento para reuniões quando o recurso "Tome notas por mim" foi usado. classic_use_case_relevel_content Sala de Aula: o usuário clica no botão "Gerar" na página "Adaptar o nível do texto", que gera uma versão atualizada do texto especificado, adequada para a série de entrada. classic_use_case_sheets_turbofill Planilhas: o usuário aceita uma sugestão proativa para preencher uma coluna com dados de texto com base em outra coluna na tabela. classic_use_case_suggest_time_reporting Gmail: o usuário aceitou uma sugestão gerada pelo Gemini para um horário a ser oferecido ao agendar uma reunião usando "Me ajude a marcar reunião" ao escrever um e-mail. classic_use_case_teleprompter_word_match Vids: usado para o teleprompter inteligente do estúdio de gravação, para combinar palavras de um roteiro com a fala de um usuário em tempo real usando um modelo de fala para texto. classic_use_case_translate_text Sala de Aula: o usuário clica no botão "Traduzir" na página "Traduzir texto", que traduz o texto de entrada para o idioma selecionado. condense Gmail: encurta o conteúdo do rascunho quando o usuário clica em "Encurtar" no menu de refinamento. Apresentações: corresponde ao botão "Encurtar" no ponto de entrada "Me ajude a escrever" na caixa de texto. O Gemini retorna uma versão encurtada da caixa de texto selecionada. . conversation Um comando é enviado ao painel lateral do Gemini. Isso pode ser iniciado pelo usuário diretamente ou por outro recurso em nome do usuário (por exemplo, uma sugestão na grade). custom_prompt Apresentações: corresponde à entrada "Modificar com um comando" no ponto de entrada "Me ajude a escrever" na caixa de texto. O Gemini retorna uma versão reformulada da caixa de texto selecionada de acordo com o comando do usuário. describe_gemini_uses Chat: descreve os usos do Gemini no contexto no painel lateral. Meet: "O que o Gemini pode fazer no Google Meet?" no painel lateral. Planilhas: o usuário pede ao Gemini para descrever os recursos ou sugerir maneiras de usar o recurso. . elaborate Gmail: expande o conteúdo do rascunho quando o usuário clica em "Elaborar" no menu de refinamento. formalize Gmail: formaliza o conteúdo do rascunho quando o usuário clica em "Formalizar" no menu de refinamento. Apresentações: corresponde ao botão "Mais formal" no ponto de entrada "Me ajude a escrever" na caixa de texto. O Gemini retorna uma versão reformulada da caixa de texto selecionada com um tom mais formal. . generate_ai_function_response Planilhas: o Gemini gera conteúdo diretamente em uma célula ou intervalo. Isso é acionado quando um usuário insere manualmente a função =AI() ou usa um recurso que gera conteúdo na grade em nome dele. generate_avatar_video Vids: gera um vídeo de um avatar digital quando um usuário fornece um roteiro e clica em "Gerar" na barra lateral do avatar de IA. generate_document Vids: gera um vídeo do Google com base em um comando, em arquivos anexados, em uma estrutura gerada e em um modelo compatível da caixa de diálogo "Introdução". Apresentações: gera um conjunto de slides do Google com base em um comando e em todas as fontes e estilos fornecidos na caixa de diálogo "Introdução". . generate_form Formulários: gera um formulário com base no comando do usuário; acionado quando o usuário clica em "Criar" na caixa de diálogo "Me ajude a criar". A caixa de diálogo fica visível ao criar um novo formulário ou quando o usuário clica no botão "Me ajude a criar". generate_form_questions Formulários: gera mais perguntas para o formulário atual quando o botão "Sugerir perguntas" é clicado. O botão é mostrado para formulários não publicados, quando ele já tem algum conteúdo (título não padrão e no mínimo duas perguntas). generate_image_for_current_page Apresentações: geração de imagens sem comando para slides. O usuário insere um comando como "sugerir uma imagem para este slide". O Gemini primeiro gera o comando de imagem e, em seguida, o usa para gerar imagens a serem retornadas ao usuário. generate_images_in_product Vids: gera uma imagem quando um usuário insere um comando de texto e clica em "Criar" na barra lateral "Gerar uma imagem". Meet: aciona o painel lateral, o usuário insere um comando de texto e clica no botão "Criar exemplos". O Meet usa o comando de texto de entrada para gerar algumas imagens que o usuário pode usar como imagem de plano de fundo visual. Apresentações: o usuário clica no ponto de entrada "Me ajude a visualizar" nas apresentações. O modelo de imagem retorna as imagens geradas ao usuário. . generate_nudge_prompts Planilhas: o Gemini sugere proativamente recursos ou comandos para o usuário testar por meio de sugestões na grade. generate_starter_active_view O Gemini gera comandos iniciais sugeridos para usuários que utilizam o contexto ativo. generate_starter_freeform Gera uma resposta quando os blocos de sugestões são clicados. generate_starter_tile_prompts O Gemini mostra comandos iniciais semicontextuais como blocos no painel lateral para ajudar os usuários a começar. generate_table_name Planilhas: o Gemini adiciona automaticamente um nome de tabela (com base no conteúdo da tabela) para uma tabela recém-convertida de uma sugestão de conversão de tabela. generate_text Gmail: gera um rascunho inteligente quando o usuário clica em "Criar" na entrada do comando "Me ajude a escrever". generate_videos_in_product Vids: gera um vídeo quando um usuário insere um comando de texto na barra lateral "Clipe de vídeo de IA". live_generate_document Documentos: gera um documento com base em uma conversa ao vivo com o usuário. outpaint Vids: gera uma versão expandida de uma imagem selecionada, estendendo-se além das bordas originais, quando um usuário solicita a pintura externa no comando e clica em "Criar" na barra lateral "Gerar uma imagem". paraphrase Apresentações: corresponde ao botão "Reformular" no ponto de entrada "Me ajude a escrever" na caixa de texto. O Gemini retorna o texto selecionado reformulado de uma maneira diferente. proactive_suggestions Gera texto para blocos de sugestões proativas com base no contexto. proactive_suggestions_response O usuário selecionou uma sugestão proativa para testar no painel lateral do Gemini e uma resposta foi gerada. proofread remove_background Vids: remove o plano de fundo de uma imagem selecionada, tornando-a transparente, quando um usuário clica no botão "Remover plano de fundo" na barra de ferramentas flutuante da imagem. replace_background Vids: substitui o plano de fundo de uma imagem selecionada quando um usuário fornece um comando que descreve o novo plano de fundo e clica em "Criar" na barra lateral "Gerar uma imagem". search_web O usuário pesquisou na Web usando o painel lateral do Gemini. suggest_time Agenda: sugestões de horário solicitadas para uma reunião. summarize O Gemini resume o contexto atual. summarize_document_comment_thread Resuma uma conversa de comentários em um documento. summarize_drive_homepage_doclist_files Mostra um resumo curto do arquivo inline na lista de arquivos da página inicial do Drive. summarize_drive_homepage_doclist_files_long Mostra um resumo mais longo do arquivo quando o usuário clica em "Ver detalhes" na lista de arquivos da página inicial do Drive. summarize_file Chat: gera um resumo de um arquivo no painel lateral do chat quando o usuário clica no botão de resumo em um card de visualização de arquivo do Drive na interface do chat. summarize_proactive O Gemini gera e mostra proativamente um resumo do conteúdo ativo detectado quando o painel lateral é aberto. summarize_proactive_short O Gemini gera um resumo ou título proativo curto para o conteúdo do usuário. user_confirmed_tools_operation O usuário clica nos botões que aparecem no painel lateral para confirmar a operação durante uma conversa. app_name string Nome do aplicativo do Workspace em que a ação foi realizada. Valores possíveis: gemini_app chat classroom docs drive gmail keep meet sheets slides vids event_category string O nome da categoria de evento indica o tipo de ação de IA generativa. Valores possíveis: active_conversations Representa uma conversa com o Gemini. active_generate Representa os recursos de geração do Gemini. Exemplo: GENERATE_IMAGES ou GENERATE_SLIDES. active_summarize Representa os recursos de resumo do Gemini. Exemplo: SUMMARIZE_THREAD. active_unspecified Representa uma categoria que não é de geração nem de resumo. inactive Representa uma categoria em que o usuário não está interagindo ativamente com o Gemini, ou seja, não é contabilizada no uso ativo. unknown Representa uma categoria que não está classificada. feature_source string Identifica onde uma interação de IA generativa se origina na interface do usuário. Valores possíveis: 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
Exemplo de solicitação	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 da mensagem do Admin Console	{actor} used Gen AI in {app_name}