Gemini in Workspace Apps Activity Events

이 문서에는 다양한 유형의 Workspace 앱의 Gemini 활동 이벤트의 이벤트와 매개변수가 나열되어 있습니다. applicationName=gemini_in_workspace_apps로 Activities.list()를 호출하여 이러한 이벤트를 가져올 수 있습니다.

참고: 'Workspace 앱의 Gemini' 로그는 2025년 6월 20일 00:00:00Z부터 제공됩니다. 이 날짜부터 최대 180일의 기록이 유지됩니다.

Workspace 앱의 Gemini 활용 이벤트

사용 관련 이벤트의 이벤트 유형입니다. 이 유형의 이벤트는 type=ai_usage_event와 함께 반환됩니다.

생성형 AI 사용

사용자가 Workspace 앱에서 Gemini를 사용하는 작업을 실행하면 이벤트가 트리거됩니다.

이벤트 세부정보
이벤트 이름	feature_utilization
매개변수	action string Gemini에 의해 시작되거나 지원되는 Workspace 애플리케이션 내에서 사용자가 실행한 작업입니다. 가능한 값은 다음과 같습니다. add_to_calendar Gmail: 사용자가 Gemini를 사용하여 이메일에서 추출한 일정을 캘린더에 추가했습니다. auto_proofread Gmail: 최소 문장 수준의 세부사항으로 인라인 초안을 다듬는 사용 사례 초안 품질을 개선하기 위한 사전 제안을 제공합니다. bulletize 슬라이드: 텍스트 상자 아래의 글쓰기 도우미 진입점에서 '요점 형식으로 변환' 버튼에 해당합니다. Gemini가 선택한 텍스트를 글머리 기호로 정리하여 반환합니다. classic_use_case_convert_rubric 클래스룸: 사용자가 과제 생성 페이지에서 '+루브릭'을 클릭한 다음 '파일에서 변환'을 클릭하여 입력된 Drive 파일을 기반으로 평가 루브릭을 업로드합니다. classic_use_case_generate_audio_lesson Classroom: 사용자가 '오디오 수업 생성' 버튼을 클릭하면 입력된 학년, 주제 또는 콘텐츠를 기반으로 스크립트의 슬라이드 프레젠테이션을 포함한 오디오 수업이 생성됩니다. classic_use_case_generate_choice_board Classroom: 사용자가 선택판 만들기 페이지에서 '생성' 버튼을 클릭하면 입력된 학년, 주제, 교육 자료를 기반으로 학생 연습 샘플 보드가 생성됩니다. classic_use_case_generate_common_misconceptions 클래스룸: 사용자가 일반적인 오해 해결 페이지에서 '생성' 버튼을 클릭하면 입력된 학년 및 주제를 기반으로 학생이 직면하는 일반적인 문제 목록이 생성됩니다. classic_use_case_generate_feedback 클래스룸: 사용자가 과제 채점 페이지에서 '글쓰기 도우미'를 클릭하면 입력된 성적 및 의견 주제를 기반으로 학생 제출물에 관한 댓글이 생성됩니다. classic_use_case_generate_hooks 클래스룸: 사용자가 '관심을 끄는 도입부 만들기' 페이지에서 '생성' 버튼을 클릭하면 입력된 학년, 수업, 교육 자료를 기반으로 짧은 학생 연습 문제가 생성됩니다. classic_use_case_generate_informative_articles 클래스룸: 사용자가 정보 텍스트 작성 페이지에서 '생성' 버튼을 클릭하면 입력된 주제를 설명하는 텍스트가 입력된 학년에 맞게 생성됩니다. classic_use_case_generate_lesson_plan 클래스룸: 사용자가 '수업 계획 생성' 버튼을 클릭하면 입력된 학년, 주제, 교육 자료를 기반으로 수업 계획이 생성됩니다. classic_use_case_generate_presentation 클래스룸: 사용자가 '프레젠테이션 개요 생성' 버튼을 클릭하면 입력된 학년, 주제, 프레젠테이션 길이를 기반으로 Slides 프레젠테이션이 생성됩니다. classic_use_case_generate_project_activities 클래스룸: 사용자가 '프로젝트 생성' 버튼을 클릭하면 입력된 학년, 주제, 교육 자료를 기반으로 여러 개별 또는 그룹 프로젝트 아이디어가 생성됩니다. classic_use_case_generate_questions 클래스룸: 사용자가 '질문 생성' 버튼을 클릭하면 입력된 학년, 주제, 질문 유형을 기반으로 질문 목록이 생성됩니다. classic_use_case_generate_rubric 클래스룸: 사용자가 기준표 만들기 페이지에서 '기준 생성' 버튼을 클릭하면 입력된 학년, 성취도 등급, 과제 안내에 따라 평가 기준표가 생성됩니다. classic_use_case_generate_story 클래스룸: 사용자가 '스토리 작성' 페이지에서 '생성' 버튼을 클릭하면 입력된 학년, 주제, 키워드를 기반으로 짧은 이야기가 생성됩니다. classic_use_case_generate_text_dependent_questions Classroom: 사용자가 독해력 개발 질문 페이지에서 '질문 생성' 버튼을 클릭하면 입력된 학년, 질문 유형, 독해력, 텍스트 프롬프트를 기반으로 질문 목록이 생성됩니다. classic_use_case_generate_vocab_list 클래스룸: 사용자가 어휘 목록 만들기에서 '생성' 버튼을 클릭하면 입력된 학년, 주제, 교육 자료를 기반으로 어휘 단어 및 정의 목록이 생성됩니다. classic_use_case_meet_studio_lighting Meet: 조명이 어두운 환경에서 사용자의 동영상을 개선하고 사용자가 가상 광원을 사용하여 더 세부적으로 제어할 수 있습니다. classic_use_case_meet_studio_look Meet: 필요할 때 사용자 기능을 선명하게 합니다. classic_use_case_meet_studio_sound Meet: 필요한 경우 오디오 품질을 개선합니다. 특히 블루투스 협대역 마이크를 사용하는 경우에 그렇습니다. classic_use_case_meet_take_notes_for_me_session Meet: 자동 회의록 기능을 사용한 경우 회의 문서를 생성합니다. classic_use_case_relevel_content 클래스룸: 사용자가 텍스트 수준 조정 페이지에서 '생성' 버튼을 클릭하면 입력된 학년에 적합한 업데이트된 버전의 텍스트가 생성됩니다. classic_use_case_sheets_turbofill Sheets: 사용자가 테이블의 다른 열을 기반으로 텍스트 데이터로 열을 채우라는 사전 제안을 수락합니다. classic_use_case_suggest_time_reporting Gmail: 사용자가 메일을 작성하는 동안 '일정 도우미'를 사용하여 회의 일정을 예약할 때 Gemini에서 생성된 제안 시간을 수락했습니다. classic_use_case_teleprompter_word_match Google Vids: 녹화 스튜디오 스마트 텔레프롬프터에 사용됩니다. 텍스트 음성 변환 모델을 사용하여 스크립트의 단어를 사용자의 음성과 실시간으로 일치시킵니다. classic_use_case_translate_text Classroom: 사용자가 텍스트 번역 페이지에서 '번역' 버튼을 클릭하면 입력한 텍스트가 선택한 언어로 번역됩니다. condense Gmail: 사용자가 수정 메뉴에서 '줄이기'를 클릭하면 임시보관 메일의 콘텐츠가 단축됩니다. 슬라이드: 텍스트 상자 아래의 글쓰기 도우미 진입점에서 '간단하게' 버튼에 해당합니다. Gemini가 선택한 텍스트 상자의 단축된 버전을 반환합니다. conversation Gemini 측면 패널에 프롬프트가 제출됩니다. 이는 사용자가 직접 시작할 수도 있고 사용자를 대신하여 다른 기능 (예: 그리드 내 추천)이 시작할 수도 있습니다. custom_prompt 슬라이드: 텍스트 상자 아래의 글쓰기 도우미 진입점에서 '프롬프트로 수정' 입력에 해당합니다. Gemini는 사용자의 프롬프트에 따라 선택한 텍스트 상자의 다시 작성된 버전을 반환합니다. describe_gemini_uses 채팅: 측면 패널의 컨텍스트에서 Gemini 사용을 설명합니다. Meet: 측면 패널의 'Google Meet에서 Gemini로 무엇을 할 수 있나요?' Sheets: 사용자가 Gemini에게 기능을 설명하거나 기능 사용 방법을 제안해 달라고 요청합니다. elaborate Gmail: 사용자가 수정 메뉴에서 '자세히'를 클릭하면 임시보관 메일의 콘텐츠가 펼쳐집니다. formalize Gmail: 사용자가 다듬기 메뉴에서 '격식체'를 클릭하면 초안의 콘텐츠가 격식체로 바뀝니다. 슬라이드: 텍스트 상자 아래의 글쓰기 도우미 진입점에서 '더 격식 있는' 버튼에 해당합니다. Gemini는 선택한 텍스트 상자의 어조를 더 격식 있게 바꾼 버전을 반환합니다. generate_ai_function_response Sheets: Gemini가 셀 또는 범위에 직접 콘텐츠를 생성합니다. 사용자가 =AI() 함수를 수동으로 입력하거나 그리드에서 콘텐츠를 생성하는 기능을 대신 사용하는 경우에 트리거됩니다. generate_avatar_video Google Vids: 사용자가 스크립트를 제공하고 AI 아바타 사이드바에서 '생성'을 클릭하면 디지털 아바타 동영상을 생성합니다. generate_document Google Vids: 프롬프트, 첨부된 파일, 생성된 개요, 시작하기 대화상자의 지원되는 템플릿을 기반으로 Google Vids를 생성합니다. Slides: 시작하기 대화상자에서 프롬프트, 제공된 소스 및 스타일을 기반으로 Google Slides 자료를 생성합니다. generate_form 양식: 사용자 프롬프트에 따라 양식을 생성합니다. 사용자가 '동영상 제작 도우미' 대화상자에서 '만들기'를 클릭하면 트리거됩니다. 새 양식을 만들 때 또는 사용자가 '생성 도우미' 버튼을 클릭할 때 대화상자가 표시됩니다. generate_form_questions 양식: '질문 추천' 버튼을 클릭하면 기존 양식에 질문이 더 많이 생성됩니다. 이 버튼은 아직 게시되지 않은 양식에 표시되며, 이미 일부 콘텐츠 (기본 제목이 아닌 제목과 최소 2개의 질문)가 있는 경우에만 표시됩니다. generate_image_for_current_page Slides: 프롬프트 없이 슬라이드용 이미지 생성 사용자가 '이 슬라이드에 사용할 이미지를 추천해 줘'와 같은 프롬프트를 입력합니다. Gemini는 먼저 이미지 프롬프트를 생성한 다음 이를 사용하여 이미지를 생성하여 사용자에게 반환합니다. generate_images_in_product Vids: 사용자가 텍스트 프롬프트를 입력하고 '이미지 생성' 사이드바에서 '만들기'를 클릭하면 이미지를 생성합니다. Meet: 측면 패널에서 트리거되며, 사용자가 텍스트 프롬프트를 입력하고 '샘플 만들기' 버튼을 클릭합니다. Meet에서는 입력된 텍스트 프롬프트를 사용하여 사용자가 시각적 배경 이미지로 사용할 수 있는 이미지를 몇 개 생성합니다. Slides: 사용자가 Slides에서 '이미지 생성 지원 기능' 진입점을 클릭합니다. 이미지 모델이 생성된 이미지를 사용자에게 반환합니다. generate_nudge_prompts Sheets: Gemini는 그리드 내 추천을 통해 사용자가 시도할 수 있는 기능이나 프롬프트를 사전 예방적으로 제안합니다. generate_starter_active_view Gemini는 활성 컨텍스트를 활용하는 사용자에게 추천 시작 프롬프트를 생성합니다. generate_starter_freeform 시작 타일을 클릭하면 대답을 생성합니다. generate_starter_tile_prompts Gemini는 사용자가 시작할 수 있도록 초기, 반맥락적 시작 프롬프트를 측면 패널에 타일로 표시합니다. generate_table_name Sheets: 표 변환 추천에서 새로 변환된 표에 표 콘텐츠를 기반으로 표 이름이 자동으로 추가됩니다. generate_text Gmail: 사용자가 글쓰기 도우미 프롬프트 입력에서 '만들기'를 클릭하면 스마트 초안을 생성합니다. generate_videos_in_product Vids: 사용자가 'AI 동영상 클립' 사이드바에 텍스트 프롬프트를 입력하면 동영상을 생성합니다. outpaint Google Vids: 사용자가 프롬프트에서 아웃페인팅을 요청하고 '이미지 생성' 사이드바에서 '생성'을 클릭하면 선택한 이미지의 확장된 버전을 생성하여 원래 테두리 너머로 확장합니다. paraphrase 슬라이드: 텍스트 상자 아래의 글쓰기 도우미 진입점의 '바꿔 쓰기' 버튼에 해당합니다. Gemini가 선택한 텍스트를 다른 방식으로 바꿔서 반환합니다. proactive_suggestions 컨텍스트를 기반으로 사전 제안 타일의 텍스트를 생성합니다. proactive_suggestions_response 사용자가 Gemini 측면 패널에서 사용해 볼 사전 제안을 선택했고 대답이 생성되었습니다. proofread remove_background Google Vids: 사용자가 이미지 플로팅 툴바에서 '배경 삭제' 버튼을 클릭하면 선택한 이미지에서 배경이 삭제되어 투명해집니다. replace_background Google Vids: 사용자가 새 배경을 설명하는 프롬프트를 제공하고 '이미지 생성' 사이드바에서 '만들기'를 클릭하면 선택한 이미지의 배경을 바꿉니다. search_web 사용자가 Gemini 측면 패널을 사용하여 웹을 검색했습니다. suggest_time Calendar: 회의에 요청된 시간 추천 summarize Gemini가 현재 컨텍스트를 요약합니다. summarize_document_comment_thread 문서의 댓글 스레드를 요약해 줘. summarize_drive_homepage_doclist_files Drive 홈페이지 파일 목록에 짧은 파일 요약을 인라인으로 표시합니다. summarize_drive_homepage_doclist_files_long 사용자가 Drive 홈페이지 파일 목록에서 '세부정보 보기'를 클릭하면 더 긴 파일 요약이 표시됩니다. summarize_file 채팅: 사용자가 채팅 UI에서 Drive 파일 미리보기 카드의 요약 버튼을 클릭하면 채팅 측면 패널에 파일 요약을 생성합니다. summarize_proactive 측면 패널이 열리면 Gemini가 감지된 활성 콘텐츠의 요약을 사전 대응적으로 생성하여 표시합니다. summarize_proactive_short Gemini가 사용자의 콘텐츠에 대한 짧은 사전 예방적 요약 또는 제목을 생성합니다. user_confirmed_tools_operation 사용자가 대화 중에 측면 패널에 표시되는 버튼을 클릭하여 작업을 확인합니다. app_name string 작업이 수행된 Workspace 애플리케이션의 이름입니다. 가능한 값은 다음과 같습니다. gemini_app chat classroom docs drive gmail keep meet sheets slides vids event_category string 이벤트 카테고리 이름은 생성형 AI 작업의 유형을 나타냅니다. 가능한 값은 다음과 같습니다. active_conversations Gemini와의 대화를 나타냅니다. active_generate Gemini의 생성 기능을 나타냅니다. 예: GENERATE_IMAGES 또는 GENERATE_SLIDES active_summarize Gemini의 요약 기능을 나타냅니다. 예: SUMMARIZE_THREAD active_unspecified 생성도 요약도 아닌 카테고리를 나타냅니다. inactive 사용자가 Gemini와 적극적으로 상호작용하지 않는 것으로 간주되는 카테고리를 나타냅니다. 활성 사용량에 포함되지 않습니다. unknown 분류되지 않은 카테고리를 나타냅니다. feature_source string 사용자 인터페이스 내에서 생성형 AI 상호작용이 시작되는 위치를 식별합니다. 가능한 값은 다음과 같습니다. 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
샘플 요청	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
관리 콘솔 메시지 형식	{actor} used Gen AI in {app_name}