Gemini in Workspace Apps Activity Events

این سند رویدادها و پارامترهای انواع مختلف رویدادهای فعالیت Gemini در Workspace Apps را فهرست می‌کند. می‌توانید این رویدادها را با فراخوانی Activities.list() به همراه applicationName=gemini_in_workspace_apps بازیابی کنید.

توجه: گزارش‌های «Gemini در برنامه‌های Workspace» از تاریخ 2025-06-20T00:00:00Z در دسترس خواهند بود. از این تاریخ به بعد، یک تاریخچه‌ی پیوسته تا 180 روز نگهداری خواهد شد.

رویداد استفاده از برنامه‌های Gemini در فضای کاری

نوع رویداد برای رویدادهای مرتبط با استفاده. رویدادهایی از این نوع با type=ai_usage_event برگردانده می‌شوند.

کاربرد هوش مصنوعی عمومی

این رویداد زمانی آغاز می‌شود که کاربر عملی را انجام دهد که در آن از Gemini در هر یک از برنامه‌های Workspace استفاده می‌شود.

جزئیات رویداد
نام رویداد feature_utilization
پارامترها
action

string

عملی که توسط کاربر در یک برنامه Workspace انجام می‌شود و توسط Gemini آغاز یا پشتیبانی می‌شود. مقادیر ممکن:

  • add_to_calendar
    جیمیل: کاربر با استفاده از Gemini رویدادی را که از ایمیلش استخراج شده بود به تقویمش اضافه کرد.
  • auto_proofread
    جیمیل: مورد استفاده برای اصلاح پیش‌نویس درون‌خطی با حداقل جزئیات در سطح جمله. این سرویس پیشنهادهای پیشگیرانه‌ای برای بهبود کیفیت پیش‌نویس ارائه می‌دهد.
  • bulletize
    اسلایدها: مربوط به دکمه‌ی «بولتایز» در بخش «کمک به من در نوشتن» در زیر کادر متن است. جمینی متن انتخاب شده را به صورت سازماندهی شده در نقاط بولت برمی‌گرداند.
  • classic_use_case_convert_rubric
    کلاس درس: کاربر در صفحه ایجاد تکلیف روی «+Rubric» کلیک می‌کند، سپس روی «Convert from file» کلیک می‌کند که یک 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
    کلاس درس: کاربر روی دکمه «ایجاد طرح کلی ارائه» کلیک می‌کند که بر اساس نمره ورودی، موضوع و طول ارائه، یک ارائه اسلاید ایجاد می‌کند.
  • 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
    ملاقات: ویدیوی کاربر را در شرایط نوری ضعیف بهبود می‌بخشد و به کاربران امکان می‌دهد از منابع نور مجازی برای کنترل دقیق‌تر استفاده کنند.
  • classic_use_case_meet_studio_look
    ملاقات: در صورت نیاز، ویژگی‌های کاربر را تقویت می‌کند.
  • classic_use_case_meet_studio_sound
    ملاقات: در صورت نیاز، کیفیت صدا را بهبود می‌بخشد. به‌ویژه هنگام استفاده از میکروفون باند باریک بلوتوث.
  • classic_use_case_meet_take_notes_for_me_session
    ملاقات: وقتی از ویژگی «یادداشت‌برداری برای من» استفاده شده باشد، یک سند برای جلسات ایجاد می‌کند.
  • classic_use_case_relevel_content
    کلاس درس: کاربر روی دکمه «تولید» در صفحه متن سطح‌بندی مجدد کلیک می‌کند، که نسخه‌ای به‌روز شده از متن مشخص شده او، متناسب با نمره ورودی، تولید می‌کند.
  • classic_use_case_sheets_turbofill
    برگه‌ها: کاربر پیشنهاد فعال برای پر کردن یک ستون با داده‌های متنی بر اساس ستون دیگری در جدول خود را می‌پذیرد.
  • classic_use_case_suggest_time_reporting
    جیمیل: کاربر پیشنهاد ایجاد شده توسط جمینی را برای ارائه زمان هنگام برنامه‌ریزی جلسه با استفاده از «به من در برنامه‌ریزی کمک کنید» هنگام نوشتن ایمیل پذیرفت.
  • classic_use_case_teleprompter_word_match
    ویدیوها: برای تله‌پرامپتر هوشمند استودیوی ضبط استفاده می‌شود تا کلمات را از یک متن به گفتار کاربر در زمان واقعی با استفاده از یک مدل گفتار به متن تطبیق دهد.
  • classic_use_case_translate_text
    کلاس درس: کاربر روی دکمه «ترجمه» در صفحه متن ترجمه کلیک می‌کند که متن ورودی را به زبان انتخاب شده ترجمه می‌کند.
  • condense
    • جیمیل: وقتی کاربر روی «کوتاه کردن» در منوی پالایش کلیک می‌کند، محتوای پیش‌نویس کوتاه می‌شود.
    • اسلایدها: مربوط به دکمه "کوتاه کردن" در قسمت "کمک به من در نوشتن" در زیر کادر متن است. جمینی یک نسخه کوتاه شده از کادر متن انتخاب شده را برمی‌گرداند.
    .
  • conversation
    یک درخواست به پنل کناری Gemini ارسال می‌شود. این درخواست می‌تواند مستقیماً توسط کاربر یا توسط ویژگی دیگری از طرف کاربر (مثلاً یک پیشنهاد درون شبکه‌ای) آغاز شود.
  • custom_prompt
    اسلایدها: مربوط به ورودی «اصلاح با اعلان» در بخش «کمک به من در نوشتن» در زیر کادر متن است. Gemini نسخه‌ای بازنویسی‌شده از کادر متن انتخاب‌شده را مطابق با اعلان کاربر برمی‌گرداند.
  • describe_gemini_uses
    • چت: کاربردهای جمینی را در پنل کناری شرح می‌دهد.
    • ملاقات: «جمینی در گوگل میت چه کارهایی می‌تواند انجام دهد» در پنل کناری.
    • برگه‌ها: کاربر از Gemini می‌خواهد که قابلیت‌های آن را شرح دهد یا روش‌هایی برای استفاده از این ویژگی پیشنهاد دهد.
    .
  • elaborate
    جیمیل: وقتی کاربر روی «توضیح» در منوی پالایش کلیک می‌کند، محتوای پیش‌نویس را گسترش می‌دهد.
  • formalize
    • جیمیل: وقتی کاربر روی «رسمی‌سازی» در منوی پالایش کلیک می‌کند، محتوای پیش‌نویس را رسمی می‌کند.
    • اسلایدها: مربوط به دکمه «رسمی‌تر» در بخش «کمک به من در نوشتن» در زیر کادر متن است. جمینی نسخه‌ای بازنویسی‌شده از کادر متن انتخاب‌شده را برمی‌گرداند که لحنی رسمی‌تر دارد.
    .
  • generate_ai_function_response
    Sheets: Gemini محتوا را مستقیماً در یک سلول یا محدوده تولید می‌کند. این زمانی فعال می‌شود که کاربر به صورت دستی تابع =AI() را وارد کند یا از ویژگی‌ای استفاده کند که از طرف او محتوا را در شبکه تولید می‌کند.
  • generate_avatar_video
    Vids: وقتی کاربر اسکریپتی را ارائه می‌دهد و روی «تولید» در نوار کناری آواتار هوش مصنوعی کلیک می‌کند، ویدئویی از آواتار دیجیتال تولید می‌کند.
  • generate_document
    • ویدیوها: بر اساس یک درخواست، هرگونه فایل پیوست شده، یک طرح کلی تولید شده و یک الگوی پشتیبانی شده از کادر محاوره‌ای شروع به کار، یک ویدیوی گوگل تولید می‌کند.
    • اسلایدها: بر اساس یک درخواست و هرگونه منبع و سبک ارائه شده از کادر گفتگوی شروع به کار، یک دسته اسلاید گوگل ایجاد می‌کند.
    .
  • generate_form
    فرم‌ها: بر اساس درخواست کاربر، فرمی ایجاد می‌کند؛ زمانی که کاربر در کادر محاوره‌ای «کمک به من برای ایجاد» روی «ایجاد» کلیک می‌کند، فعال می‌شود. این کادر محاوره‌ای هنگام ایجاد یک فرم جدید یا در صورت کلیک کاربر روی دکمه «کمک به من برای ایجاد» قابل مشاهده است.
  • generate_form_questions
    فرم‌ها: وقتی روی دکمه‌ی «پیشنهاد سوال» کلیک می‌شود، سوالات بیشتری برای فرم موجود ایجاد می‌شود؛ این دکمه برای فرم‌های منتشر نشده، زمانی که از قبل محتوایی داشته باشند (عنوان غیر پیش‌فرض و حداقل ۲ سوال)، نمایش داده می‌شود.
  • generate_image_for_current_page
    اسلایدها: تولید تصویر بدون اعلان برای اسلایدها. کاربر اعلانی مانند «یک تصویر برای این اسلاید پیشنهاد دهید» را وارد می‌کند. Gemini ابتدا اعلان تصویر را تولید می‌کند و سپس از آن برای تولید تصاویر برای بازگشت به کاربر استفاده می‌کند.
  • generate_images_in_product
    • Vids: وقتی کاربر یک متن وارد می‌کند و روی «ایجاد» در نوار کناری «ایجاد تصویر» کلیک می‌کند، یک تصویر تولید می‌کند.
    • Meet: از پنل کناری فعال می‌شود، کاربر متن مورد نظر را وارد می‌کند و روی دکمه «ایجاد نمونه‌ها» کلیک می‌کند؛ Meet از متن ورودی برای تولید چند تصویر استفاده می‌کند که کاربر می‌تواند از آنها به عنوان تصویر پس‌زمینه بصری خود استفاده کند.
    • اسلایدها: کاربر روی نقطه ورود «کمک به تجسم» در اسلایدها کلیک می‌کند؛ مدل تصویر تصاویر تولید شده را به کاربر برمی‌گرداند.
    .
  • generate_nudge_prompts
    برگه‌ها: Gemini به طور فعال ویژگی‌ها یا درخواست‌هایی را برای امتحان کردن به کاربر از طریق پیشنهاد روی شبکه پیشنهاد می‌دهد.
  • generate_starter_active_view
    جمینی با استفاده از زمینه فعال، پیام‌های آغازین پیشنهادی را به کاربران ارائه می‌دهد.
  • generate_starter_freeform
    وقتی روی کاشی‌های آغازین کلیک می‌شود، پاسخی تولید می‌کند.
  • generate_starter_tile_prompts
    Gemini پیام‌های آغازین و نیمه‌متناهی را به صورت کاشی‌هایی در پنل کناری نمایش می‌دهد تا به کاربران در شروع کار کمک کند.
  • generate_table_name
    برگه‌ها: جمینی به‌طور خودکار نام جدول (بر اساس محتوای جدول) را برای جدولی که تازه تبدیل شده است، از پیشنهاد تبدیل جدول، اضافه می‌کند.
  • generate_text
    جیمیل: وقتی کاربر روی «ایجاد» روی گزینه «به من در نوشتن ورودی کمک کنید» کلیک می‌کند، یک پیش‌نویس هوشمند ایجاد می‌کند.
  • generate_videos_in_product
    Vids: وقتی کاربر در نوار کناری «کلیپ ویدیویی هوش مصنوعی» متنی را وارد می‌کند، یک ویدیو تولید می‌کند.
  • outpaint
    Vids: وقتی کاربر در اعلان خود درخواست رنگ‌آمیزی بیرونی (outpainting) می‌دهد و روی «ایجاد» در نوار کناری «ایجاد یک تصویر» کلیک می‌کند، یک نسخه گسترش‌یافته از تصویر انتخاب‌شده ایجاد می‌کند که فراتر از مرزهای اصلی آن گسترش می‌یابد.
  • paraphrase
    اسلایدها: مربوط به دکمه‌ی «بازنویسی» در بخش «کمک به من در نوشتن» در زیر کادر متن است. جمینی متن انتخاب شده را به شیوه‌ای متفاوت بازنویسی می‌کند.
  • proactive_suggestions
    متن را برای کاشی‌های پیشنهاد پیشگیرانه بر اساس زمینه تولید می‌کند.
  • proactive_suggestions_response
    کاربر یک پیشنهاد پیشگیرانه را برای امتحان کردن در پنل کناری Gemini انتخاب کرد و پاسخی ایجاد شد.
  • proofread
  • remove_background
    Vids: وقتی کاربر روی دکمه‌ی «حذف پس‌زمینه» در نوار ابزار شناور تصویر کلیک می‌کند، پس‌زمینه را از تصویر انتخاب‌شده حذف کرده و آن را شفاف می‌کند.
  • replace_background
    Vids: وقتی کاربر توضیحی در مورد پس‌زمینه جدید ارائه می‌دهد و روی «ایجاد» در نوار کناری «ایجاد تصویر» کلیک می‌کند، پس‌زمینه را برای تصویر انتخاب‌شده جایگزین می‌کند.
  • search_web
    کاربر با استفاده از پنل کناری Gemini در وب جستجو کرد.
  • suggest_time
    تقویم: پیشنهادهای زمان درخواستی برای جلسه.
  • summarize
    جمینی خلاصه‌ای از شرایط فعلی ارائه می‌دهد.
  • summarize_document_comment_thread
    خلاصه کردن یک رشته نظر در یک سند.
  • summarize_drive_homepage_doclist_files
    خلاصه‌ای کوتاه از فایل را به صورت درون‌خطی در فهرست فایل‌های صفحه اصلی درایو نمایش می‌دهد.
  • summarize_drive_homepage_doclist_files_long
    وقتی کاربر روی «مشاهده جزئیات» در فهرست فایل‌های صفحه اصلی درایو کلیک می‌کند، خلاصه فایل طولانی‌تری نمایش داده می‌شود.
  • summarize_file
    چت: وقتی کاربر روی دکمه خلاصه در کارت پیش‌نمایش فایل درایو در رابط کاربری چت کلیک می‌کند، خلاصه‌ای از یک فایل در پنل کناری چت ایجاد می‌شود.
  • summarize_proactive
    Gemini به طور فعال خلاصه‌ای از محتوای فعال شناسایی شده را هنگام باز شدن پنل کناری تولید و نمایش می‌دهد.
  • summarize_proactive_short
    جمینی یک خلاصه یا عنوان کوتاه و پیشگیرانه برای محتوای کاربر تولید می‌کند.
  • user_confirmed_tools_operation
    کاربر برای تأیید عملیات در حین مکالمه، روی دکمه‌هایی که در پنل کناری ظاهر می‌شوند کلیک می‌کند.
app_ name

string

نام برنامه‌ی فضای کاری که از طریق آن عمل انجام شده است. مقادیر ممکن:

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

string

نام دسته رویداد، نوع اقدام هوش مصنوعی مولد را نشان می‌دهد. مقادیر ممکن:

  • active_conversations
    نشان دهنده گفتگو با جوزا است.
  • active_generate
    نشان‌دهنده‌ی قابلیت‌های تولید جمینی است - مثال: GENERATE_IMAGES یا GENERATE_SLIDES.
  • active_summarize
    نشان‌دهنده قابلیت‌های خلاصه‌سازی Gemini است. مثال: SUMMARIZE_THREAD.
  • active_unspecified
    نشان‌دهنده‌ی دسته‌بندی‌ای است که نه تولید می‌شود و نه خلاصه می‌شود.
  • inactive
    نشان‌دهنده دسته‌بندی‌ای است که در آن، کاربر به طور فعال با Gemini تعامل ندارد؛ این موضوع جزو استفاده فعال محسوب نمی‌شود.
  • unknown
    نشان دهنده دسته ای است که طبقه بندی نشده است.
feature_ source

string

مشخص می‌کند که یک تعامل هوش مصنوعی مولد از کجا در رابط کاربری سرچشمه می‌گیرد. مقادیر ممکن:

  • 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}