Gemini in Workspace Apps Activity Events
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 문서에는 다양한 유형의 Workspace 앱 활동 이벤트의 Gemini에 대한 이벤트 및 매개변수가 나와 있습니다. applicationName=gemini_in_workspace_apps를 사용하여 Activities.list()를 호출하면 이러한 이벤트를 가져올 수 있습니다.
참고: 'Workspace 앱의 Gemini' 로그는 2025년 6월 20일 오전 12시(UTC)부터 사용할 수 있습니다. 이 날짜부터 최대 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 Slides: 텍스트 상자 아래의 글쓰기 도우미 진입 지점에 있는 '글머리 기호로 정리' 버튼에 해당합니다. Gemini가 선택한 텍스트를 글머리 기호로 정리하여 반환합니다.
classic_use_case_convert_rubric 클래스룸: 사용자가 과제 생성 페이지에서 '+기준표'를 클릭한 다음 '파일에서 변환'을 클릭하면 입력된 Drive 파일을 기반으로 평가 기준표가 업로드됩니다.
classic_use_case_generate_audio_lesson 클래스룸: 사용자가 '오디오 수업 생성' 버튼을 클릭하면 입력된 학년, 주제 또는 콘텐츠를 기반으로 스크립트의 슬라이드 프레젠테이션을 포함한 오디오 수업이 생성됩니다.
classic_use_case_generate_choice_board 클래스룸: 사용자가 '초이스 보드 만들기' 페이지에서 '생성' 버튼을 클릭하면 입력된 학년, 주제, 교육 자료를 기반으로 샘플 학생 연습 보드가 생성됩니다.
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 클래스룸: 사용자가 '독해 문제 개발' 페이지에서 '질문 생성' 버튼을 클릭하면 입력된 학년, 질문 유형, 읽기 능력, 텍스트 프롬프트를 기반으로 질문 목록이 생성됩니다.
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_notebooklm_generate_chat_response 사용자의 질문에 대한 대화형 응답을 생성합니다.
classic_use_case_notebooklm_generate_notebook_guide 사용자가 업로드한 소스를 기반으로 노트북 가이드를 생성합니다.
classic_use_case_notebooklm_generate_source_guide 사용자가 선택한 특정 업로드 소스에 대한 소스 가이드를 생성합니다.
classic_use_case_notebooklm_generate_studio_artifact 사용자가 시작하면 사용자의 소스를 기반으로 스튜디오 아티팩트를 생성합니다.
classic_use_case_notebooklm_perform_source_discovery 사용자가 입력한 검색 매개변수를 기반으로 잠재적인 소스 옵션을 검색합니다.
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 클래스룸: 사용자가 텍스트 번역 페이지에서 '번역' 버튼을 클릭하면 입력 텍스트가 선택한 언어로 번역됩니다.
condense
Gmail: 사용자가 수정 메뉴에서 '줄이기'를 클릭하면 초안의 콘텐츠를 줄입니다.
Slides: 텍스트 상자 아래의 글쓰기 도우미 진입 지점에 있는 '줄이기' 버튼에 해당합니다. Gemini가 선택한 텍스트 상자의 축약된 버전을 반환합니다.
conversation Gemini 측면 패널에 프롬프트가 제출됩니다. 이는 사용자가 직접 시작하거나 사용자를 대신하여 다른 기능(예: 그리드 내 추천)을 통해 시작할 수 있습니다.
custom_prompt Slides: 텍스트 상자 아래의 글쓰기 도우미 진입 지점에 있는 '프롬프트로 수정' 입력에 해당합니다. Gemini는 사용자의 프롬프트에 따라 선택한 텍스트 상자의 수정된 버전을 반환합니다.
describe_gemini_uses
채팅: 측면 패널에서 Gemini를 사용하는 방법을 설명합니다.
Meet: 측면 패널의 'Google Meet에서 Gemini로 무엇을 할 수 있나요?'
시트: 사용자가 Gemini에게 기능을 설명하거나 기능을 사용하는 방법을 제안해 달라고 요청합니다.
elaborate Gmail: 사용자가 수정 메뉴에서 '자세히 작성'을 클릭하면 초안의 콘텐츠가 확장됩니다.
formalize
Gmail: 사용자가 수정 메뉴에서 '격식체로 변경'을 클릭하면 초안의 콘텐츠를 격식체로 변경합니다.
I am going to provide a list of glossary for this session. Use these terms as references, but apply your own judgment based on the definitions provided. If a term doesn't fit the context, just ignore the suggestion.
Source Term: Help me write
The definition is: A feature that uses generative AI to help the user write or rewrite text, e.g. emails, blog posts, etc.
Translation under this definition: 글쓰기 도우미
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 Forms: 사용자 프롬프트를 기반으로 양식을 생성합니다. 사용자가 '양식 작성 도우미' 대화상자에서 '만들기'를 클릭하면 트리거됩니다. 이 대화상자는 새 양식을 만들 때 또는 사용자가 '양식 작성 도우미' 버튼을 클릭할 때 표시됩니다.
generate_form_questions Forms: '질문 추천' 버튼을 클릭하면 기존 양식에 더 많은 질문이 생성됩니다. 이 버튼은 게시되지 않은 양식에 이미 일부 콘텐츠(기본값이 아닌 제목 및 최소 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: Gemini가 표 변환 추천에서 새로 변환된 표에 표 콘텐츠를 기반으로 표 이름을 자동으로 추가합니다.
generate_videos_in_product Vids: 사용자가 'AI 동영상 클립' 사이드바에 텍스트 프롬프트를 입력하면 동영상을 생성합니다.
live_generate_document Docs: 사용자와의 실시간 대화에서 문서를 생성합니다.
outpaint Google Vids: 사용자가 프롬프트에서 아웃페인팅을 요청하고 '이미지 생성' 사이드바에서 '만들기'를 클릭하면 선택한 이미지를 원래 테두리 너머로 확장한 버전을 생성합니다.
paraphrase Slides: 텍스트 상자 아래의 글쓰기 도우미 진입점에 있는 '다시 작성' 버튼에 해당합니다. Gemini가 선택한 텍스트를 다른 방식으로 다시 작성하여 반환합니다.
proactive_daily_briefs Chat에서 사용자를 위한 일일 브리핑을 사전에 생성합니다.
proactive_suggestions 컨텍스트를 기반으로 사전 제안 타일의 텍스트를 생성합니다.
proactive_suggestions_response 사용자가 Gemini 측면 패널에서 시도할 능동적 제안을 선택했고 대답이 생성되었습니다.
proofread
remove_background Google Vids: 사용자가 이미지 플로팅 툴바에서 '배경 삭제' 버튼을 클릭하면 선택한 이미지에서 배경을 삭제하여 투명하게 만듭니다.
replace_background 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 Chat: 사용자가 Chat UI의 Drive 파일 미리보기 카드에서 요약 버튼을 클릭하면 Chat 측면 패널에 파일 요약이 생성됩니다.
summarize_proactive Gemini는 측면 패널이 열리면 감지된 활성 콘텐츠의 요약을 사전에 생성하고 표시합니다.
summarize_proactive_short Gemini가 사용자 콘텐츠에 대한 짧은 사전 요약 또는 제목을 생성합니다.
user_confirmed_tools_operation 사용자가 대화 중에 측면 패널에 표시되는 버튼을 클릭하여 작업을 확인합니다.
app_name
string
작업이 수행된 Workspace 애플리케이션의 이름입니다.
가능한 값은 다음과 같습니다.
gemini_app
chat
classroom
docs
drive
gmail
keep
meet
notebooklm Gemini Notebook.
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
ask_gemini Chat의 Gemini에게 물어보세요.
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
샘플 요청
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
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2026-11-03(UTC)"],[],[]]