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_text
    Gmail: 사용자가 글쓰기 도우미 프롬프트 입력에서 '만들기'를 클릭하면 스마트 초안을 생성합니다.
  • 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
관리 콘솔 메시지 형식
{actor} used Gen AI in {app_name}