Gemini in Workspace Apps Activity Events

Este documento lista os eventos e parâmetros de vários tipos de eventos de atividade do Gemini nos apps do Workspace. Para recuperar esses eventos, chame Activities.list() com applicationName=gemini_in_workspace_apps.

Observação: os registros do "Gemini nos apps do Workspace" estarão disponíveis a partir de 2025-06-20T00:00:00Z. A partir dessa data, um histórico rotativo 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 refinar um rascunho inline com uma granularidade mínima no nível da frase. Ela oferece sugestões proativas para melhorar a qualidade do rascunho. bulletize Apresentações: corresponde ao botão "Criar lista com marcadores" no ponto de entrada do recurso Me ajude a escrever abaixo da caixa de texto. O Gemini retorna o texto selecionado organizado em marcadores. classic_use_case_convert_rubric Google Sala de Aula: o usuário clica em "+ Rubrica" e depois em "Converter de arquivo" na página de criação de atividades, que faz upload de uma rubrica de avaliação com base no arquivo do Drive inserido. classic_use_case_generate_audio_lesson Classroom: o usuário clica no botão "Gerar uma lição em áudio", que cria uma lição em áudio, incluindo uma apresentação Google com a transcrição, com base na série, no tema ou no conteúdo inserido. classic_use_case_generate_choice_board Classroom: o usuário clica no botão "Gerar" na página "Criar uma tabela de opções", que gera uma tabela de exemplos de exercícios para estudantes com base no ano escolar, no tema e nos materiais de ensino inseridos. classic_use_case_generate_common_misconceptions Sala de aula: o usuário clica no botão "Gerar" na página "Corrigir erros comuns", que gera uma lista de problemas comuns enfrentados pelos estudantes com base na série e no tema inseridos. classic_use_case_generate_feedback Google Sala de Aula: o usuário clica em "Me ajude a escrever" na página de avaliação da atividade, o que gera um comentário sobre o envio do estudante com base na nota 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 atraente", que gera um exercício curto para estudantes com base na série, na lição e nos materiais didáticos inseridos. classic_use_case_generate_informative_articles Sala de Aula: o usuário clica no botão "Gerar" na página "Escrever um texto informativo", que gera um texto que descreve o tema inserido, adequado para a série informada. classic_use_case_generate_lesson_plan Google Sala de Aula: o usuário clica no botão "Gerar plano de aula", que cria um plano de aula com base na série, no tema e nos materiais didáticos inseridos. classic_use_case_generate_presentation Sala de Aula: o usuário clica no botão "Gerar estrutura de apresentação", que cria uma apresentação Google com base no ano escolar, no tema e na duração da apresentação. classic_use_case_generate_project_activities Sala de Aula: o usuário clica no botão "Gerar projeto", que cria várias ideias de projetos individuais ou em grupo com base no ano escolar, no tema e nos materiais didáticos inseridos. classic_use_case_generate_questions Sala de Aula: o usuário clica no botão "Gerar perguntas", que cria uma lista de perguntas com base no ano escolar, no tema e no tipo de pergunta inseridos. 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 avaliação com base na nota inserida, no nível de desempenho e nas instruções da atividade. classic_use_case_generate_story Sala de aula: o usuário clica no botão "Gerar" na página "Escrever uma história", que gera um conto com base na série, no tema e nas palavras-chave inseridas. classic_use_case_generate_text_dependent_questions Classroom: 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. classic_use_case_generate_vocab_list Sala de Aula: o usuário clica no botão "Gerar" em "Criar uma lista de vocabulário ", que gera uma lista de palavras e definições de vocabulário com base no nível de escolaridade, no tema e nos materiais didáticos inseridos. classic_use_case_meet_studio_lighting Meet: melhora o vídeo do usuário em condições de baixa iluminação e permite usar fontes de luz virtuais para um controle mais refinado. classic_use_case_meet_studio_look Meet: melhora 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 Bluetooth de banda estreita. classic_use_case_meet_take_notes_for_me_session Meet: gera um documento para reuniões quando o recurso "Tome notas por mim" é 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 cria uma versão atualizada do texto especificado, adequada para o ano escolar informado. 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 da tabela. classic_use_case_suggest_time_reporting Gmail: o usuário aceitou uma sugestão gerada pelo Gemini de um horário para oferecer ao agendar uma reunião usando "Me ajude a marcar reunião" enquanto escrevia um e-mail. classic_use_case_teleprompter_word_match Vids: usado no teleprompter inteligente do estúdio de gravação para corresponder palavras de um roteiro à fala de um usuário em tempo real usando um modelo de conversão de voz em texto. classic_use_case_translate_text Classroom: o usuário clica no botão "Traduzir" na página "Traduzir texto", que traduz o texto inserido para o idioma selecionado. condense Gmail: reduz o conteúdo do rascunho quando o usuário clica em "Reduzir" no menu de refinamento. Apresentações: corresponde ao botão "Resumir" no ponto de entrada do recurso Me ajude a escrever abaixo da caixa de texto. O Gemini retorna uma versão abreviada da caixa de texto selecionada. . conversation Um comando é enviado ao painel lateral do Gemini. Isso pode ser iniciado diretamente pelo usuário ou por outro recurso em nome dele (por exemplo, uma sugestão na grade). custom_prompt Apresentações: corresponde à entrada "Modificar com um comando" no ponto de entrada do recurso 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 do 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: deixa o conteúdo do rascunho mais formal quando o usuário clica em "Deixar mais formal" no menu de refinamento. Apresentações: corresponde ao botão "Mais formal" no ponto de entrada do recurso Me ajude a escrever abaixo da 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 script e clica em "Gerar" na barra lateral do avatar de IA. generate_document Vids: gera um Google Vid com base em um comando, arquivos anexados, um esboço gerado e um modelo compatível na caixa de diálogo "Começar". Apresentações: gera uma apresentação Google com base em um comando e em fontes e estilos fornecidos na caixa de diálogo "Começar". . 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 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. Ele aparece para formulários não publicados que já têm algum conteúdo (título não padrão e pelo menos duas perguntas). generate_image_for_current_page Apresentações: geração de imagens sem comandos para apresentações. O usuário insere um comando como "sugira uma imagem para este slide". Primeiro, o Gemini gera o comando de imagem e depois o usa para gerar imagens e retornar 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: acionamento no painel lateral, o usuário insere um comando de texto e clica no botão "Criar amostras". O Meet usa o comando de texto inserido 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 com imagens" nas Apresentações. O modelo de imagem retorna as imagens geradas para o usuário. . generate_nudge_prompts Planilhas: o Gemini sugere proativamente recursos ou comandos para o usuário testar usando a sugestão na grade. generate_starter_active_view O Gemini gera sugestões de comandos iniciais para os usuários que usam 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 e semicontextuais como blocos no painel lateral para ajudar os usuários a começar. generate_table_name Planilhas: o Gemini adiciona automaticamente um nome (com base no conteúdo) a uma tabela recém-convertida de uma sugestão de conversão. generate_text Gmail: gera um rascunho inteligente quando o usuário clica em "criar" na entrada de comando do recurso 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 "Videoclipe de IA". outpaint Vids: gera uma versão expandida de uma imagem selecionada, estendendo-se além das bordas originais, quando um usuário solicita 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 do recurso Me ajude a escrever abaixo da caixa de texto. O Gemini retorna o texto selecionado reformulado de outra maneira. 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-o transparente, quando um usuário clica no botão "Remover plano de fundo" na barra de ferramentas flutuante de imagens. replace_background Vids: substitui o plano de fundo de uma imagem selecionada quando um usuário fornece um comando descrevendo 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: pediu sugestões de horário para uma reunião. summarize O Gemini resume o contexto atual. summarize_document_comment_thread Resumir uma sequência 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 "Resumir" em um card de visualização de arquivo do Drive na interface do chat. summarize_proactive O Gemini gera e mostra um resumo do conteúdo ativo detectado quando o painel lateral é aberto. summarize_proactive_short O Gemini gera um resumo ou título curto e proativo 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 do 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. Ex.: 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 não 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 das mensagens do Admin Console	{actor} used Gen AI in {app_name}