Gemini in Workspace Apps Activity Events

במסמך הזה מפורטים האירועים והפרמטרים של סוגים שונים של אירועי פעילות ב-Gemini בכלי Workspace. כדי לאחזר את האירועים האלה, צריך להפעיל את Activities.list() עם applicationName=gemini_in_workspace_apps.

הערה: היומנים של 'Gemini בכלי Workspace' יהיו זמינים החל מ-20 ביוני 2025 בשעה 00:00:00Z. החל מהתאריך הזה, המערכת תשמור היסטוריה מתגלגלת של עד 180 יום.

אירוע של שימוש ב-Gemini בכלי Workspace

סוג האירוע לאירועים שקשורים לשימוש. אירועים מהסוג הזה מוחזרים עם type=ai_usage_event.

שימוש ב-AI גנרטיבי

האירוע מופעל כאשר משתמש מבצע פעולה שמשתמשת ב-Gemini באחת מאפליקציות Workspace.

פרטי האירוע
שם האירוע feature_utilization
פרמטרים
action

string

פעולה שהמשתמש ביצע באפליקציית Workspace, ביוזמת Gemini או בעזרתו. ערכים אפשריים:

  • generate_starter_tile_prompts
    הצעות לתכונות של Gemini שאפשר לנסות באמצעות משבצות בחלונית הצדדית.
  • suggest_full_replies
    תשובות ש-Gemini מציע באימיילים, בשיחות וכו'
  • list_action_items_refinement
    פעולות לביצוע בתמליל של הפגישה.
  • condense
    דחיסת הפסקה שנבחרה במסמכים.
  • paraphrase
    ניסוח מחדש של פסקאות שנבחרו במסמכים.
  • generate_talkshow
    יצירת פודקאסטים של אודיו מההקשר.
  • summarize_proactive_short
    סיכום של תוכן מקובץ מסוים.
  • bulletize
    הוספת תווי פסיק לפסקה שנבחרה ב-Google Docs.
  • formalize
    הפסקה שנבחרה במסמכים הופכת לרשמית.
  • search_in_conversation
    חיפוש בתוך שיחה.
  • match_writing_style
    התאמה לסגנון הכתיבה של הטקסט הקיים.
  • comment_conversation
    יצירת תגובה בשיחה בהקשר של שרשור תגובות.
  • ask_about_context
    משמש לשאילת שאלות ל-Gemini לגבי ההקשר של המשתמש.
  • generate_image_for_current_page
    יצירת תמונות שנעשה בהן שימוש בשקופיות.
  • conversation
    צ'אטים עם Gemini.
  • proactive_suggestions_response
    יצירת הצעות יזום להנחיות.
  • summarize_proactive
    סיכום יזום של מידע רקע.
  • generate_images_in_product
    יצירת תמונה.
  • summarize
    סיכום טקסט קצר.
  • generate_starter_active_view
    יצירת הצעות להנחיות למשתמשים שמבוססות על ההקשר הפעיל.
  • generate_text
    יצירת טקסט מהנחיה כדי לעזור בכתיבה.
  • generate_document
    יצירת מסמך מלא מהנחיה.
  • describe_gemini_uses
    תיאור של שימושים ב-Gemini בהקשר.
  • remove_background
    הסרת הרקע של תמונה.
  • search_web
    חיפוש באינטרנט של הנחיה נתונה.
  • summarize_long
    סיכום טקסט ארוך.
  • classic_use_case_gemini
    סיכום של כל פעולה שבוצעה באפליקציית Gemini.
  • proofread
    בדיקת הגהה של תוכן, כמו אימיילים ומסמכים, באמצעות Gemini.
  • elaborate
    הרחבת תוכן, כמו אימיילים ומסמכים, באמצעות Gemini.
  • summarize_items
    סיכום תוכן באמצעות Gemini בתכונות כמו אימייל ומסמכים.
  • expand
    הרחבת התוכן ביכולות כמו אימיילים ומסמכים על ידי Gemini.
  • create_faq
    יצירת שאלות נפוצות לגבי תיקייה או קובץ ב-Drive.
  • informalize
    המרת המרה של טקסט לטון לא רשמי לפי הבקשה של המשתמש.
  • ask_about_this_file
    סיכום המידע על הקובץ.
  • summarize_unspecified_folder
    סיכום של פעולה בתיקייה.
  • suggest_replies
    יצירת הצעות לתשובות למשתמשים בשיחות באפליקציות שונות.
  • classic_use_case_proofread_conciseness
    יצירת טקסט מקוצר במסמך.
  • generate_videos_in_product
    יצירת סרטון לפי בקשת המשתמש באפליקציות שונות של Workspace באמצעות SidePanel.
  • outline
    יצירת תקציר מנהלים על סמך טקסט קלט.
  • generate_backgrounds
    יצירת רקע.
  • catch_me_up
    ניתוח מידע חדש ב-Drive של המשתמש וסיכום של הפעילות האחרונה, כדי לעזור למשתמש להתעדכן במהירות.
  • refine_phrasing
    שיפור טקסט ב-Gmail וב-Docs.
  • generate_starter_freeform
    הוספת משבצות ראשוניות כדי לעזור למשתמשים להתחיל להשתמש בחלונית הצדדית.
  • refine_content
    שיפור טקסט ב-Gmail וב-Docs.
  • summarize_file
    סיכום של תוכן מקובץ מסוים.
  • replace_background
    replace_background
  • summarize_unspecified_file
    סיכום קובץ.
  • outpaint
    משמש לעריכת תמונות.
  • summarize_conversation
    יצירת סיכום על סמך שיחה של הודעות בצ'אט.
  • auto_adjust_layout
    משמש להתאמה אוטומטית של הפריסה ב-Slides.
  • generate_text_completion
    משמש להשלמה אוטומטית של טקסט.
  • generate_ai_function_response
    משמש בפונקציה ‎ =AI בגיליון.
  • generate_text_for_current_page
    יצירת גוף טקסט לדף הנוכחי.
  • analyze_documents
    ניתוח מסמכים.
  • generate_title_for_current_page
    יצירת כותרת לדף הנוכחי.
  • generate_next_steps
    יצירת שלבים הבאים מההקשר של המשתמש.
  • auto_proofread
    שיפור הטקסט של הטיוטה בתוך השורה.
  • classic_use_case_meet_studio_look
  • classic_use_case_meet_studio_sound
  • conversation
  • list_action_items
  • summarize_executive_summary
  • proactive_suggestions
  • detect_schedule_intent
  • user_confirmed_tools_operation
  • generate_apps_search_overlay_suggestions
  • suggest_reply_prompts
  • summarize_dm
  • summarize_space
  • summarize_thread
  • list_action_items_filtering
  • list_action_items_proactive
  • generate_nudge_prompts
  • classic_use_case_meet_studio_lighting
  • summarize_snippet
  • add_to_calendar
  • list_action_items_annotator
  • classic_use_case_proofread_grammar
  • classic_use_case_proofread_spelling
  • generate_page_outline
  • generate_folder_suggestions
  • refine_friendly
  • summarize_sales_lead
  • refine_engaging
  • refine_persuasive
  • suggest_reply_sales
  • trigger_golden_prompt
  • custom_prompt
  • summarize_space_comprehensive
  • detect_schedule_intent_compose
  • summarize_thread_comprehensive
  • search_answer
  • find_and_organize_within_folder
  • generate_avatar_video
  • chip_agent
  • ask_about_unspecified_file
  • evaluate_natural_language_condition
  • brief
  • generate_ai_function_response_in_batch
  • suggest_time
  • categorize_content
  • find_and_organize_items_to_location
  • compare_unspecified_files
  • describe_image
  • suggest_prompts
  • report_unspecified_files
  • classic_use_case_preset_voiceover
  • classic_use_case_sheets_turbofill
  • generate_form
  • classic_use_case_proofread_sentence_splitting
  • classic_use_case_proofread_word_choice
  • classic_use_case_proofread_active_voice
  • classic_use_case_teleprompter_word_match
  • generate_form_questions
  • classic_use_case_generate_questions
  • classic_use_case_generate_rubric
  • classic_use_case_generate_vocab_list
  • classic_use_case_generate_lesson_plan
  • classic_use_case_generate_choice_board
  • classic_use_case_relevel_content
  • classic_use_case_generate_story
  • classic_use_case_generate_text_dependent_questions
  • classic_use_case_generate_common_misconceptions
  • classic_use_case_generate_hooks
  • classic_use_case_generate_project_activities
  • classic_use_case_generate_informative_articles
app_name

string

השם של אפליקציית Workspace שבאמצעותה בוצעה הפעולה. ערכים אפשריים:

  • gemini_app
  • chat
  • classroom
  • docs
  • drive
  • gmail
  • keep
  • meet
  • sheets
  • slides
  • vids
event_category

string

השם של קטגוריית האירוע מציין את סוג הפעולה של הבינה המלאכותית הגנרטיבית. ערכים אפשריים:

  • active_conversations
    הסמל הזה מייצג שיחה עם Gemini.
  • active_generate
    הקוד הזה מייצג את יכולות היצירה של Gemini. דוגמה: GENERATE_IMAGES או GENERATE_SLIDES.
  • active_summarize
    הקוד מייצג את יכולות הסיכום של Gemini. לדוגמה: SUMMARIZE_THREAD.
  • active_unspecified
    הערך הזה מייצג קטגוריה שלא נוצרה ולא נערכה סיכום שלה.
  • inactive
    הקטגוריה הזו מייצגת משתמשים שלא נחשבים כמשתמשים פעילים ב-Gemini, והם לא נספרים בנתוני השימוש הפעיל.
  • unknown
    הערך הזה מייצג קטגוריה שלא סווגה.
feature_source

string

מזהה את המיקום בממשק המשתמש שממנו מתחילה אינטראקציה עם בינה מלאכותית גנרטיבית. ערכים אפשריים:

  • adaptive_audio
  • chat_with_gemini
  • classroom_gemini_education
  • enhanced_smart_fill
  • generate_background
  • help_me_organize
  • help_me_refine
  • help_me_visualize
  • help_me_write
  • proofread
  • remove_image_background
  • side_panel
  • studio_light
  • studio_look
  • studio_sound
  • 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
פורמט ההודעות במסוף Admin
{actor} used Gen AI in {app_name}