Gemini in Workspace Apps Activity Events

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

توجه: گزارش‌های «Gemini در برنامه‌های Workspace» از تاریخ ۲۰۲۵-۰۶-۲۰T۰۰:۰۰:۰۰Z دردسترس خواهد بود. از این تاریخ به بعد، سابقه چرخشی تا ۱۸۰ روز حفظ خواهد شد.

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

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

مصرف هوشواره زایا

وقتی کاربر کنشی را انجام می‌دهد که از Gemini در هریک از برنامه‌های Workspace استفاده می‌کند، رویداد راه‌اندازی می‌شود.

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

string

اقدامی که کاربر در برنامه Workspace انجام داده است و Gemini آن را شروع کرده یا در انجام آن کمک کرده است. مقادیر احتمالی:

  • add_to_calendar
    Gmail: کاربر رویدادی را که از ایمیلش استخراج شده است بااستفاده از Gemini به تقویمش اضافه کرد.
  • auto_proofread
    Gmail: مورد استفاده برای ویرایش پیش‌نویس به‌صورت درون‌خطی با حداقل سطح جزئیات جمله. این ویژگی پیشنهادهای پیش‌کنشی برای بهبود کیفیت پیش‌نویس ارائه می‌دهد.
  • bulletize
    اسلایدنگار: با دکمه «تبدیل به فهرست نقطه‌ای» در نقطه ورودی «کمک گرفتن در نوشتن» در زیر چارگوش نوشتاری مطابقت دارد. ‫Gemini نوشتار انتخاب‌شده را به‌صورت سازمان‌دهی‌شده در قالب فهرست نقطه‌گلوله‌ای برمی‌گرداند.
  • classic_use_case_convert_rubric
    Classroom: کاربر روی «+سیستم نمره‌دهی» و سپس «تبدیل از فایل» در صفحه ایجاد «تکلیف» کلیک می‌کند، که سیستم نمره‌دهی را براساس فایل Drive ورودی بارگذاری می‌کند.
  • classic_use_case_generate_audio_lesson
    Classroom: کاربر روی دکمه «تولید درس صوتی» کلیک می‌کند، که یک درس صوتی، شامل ارائه «اسلایدنگار» از ترانویسی، براساس ورودی کلاس، موضوع، یا محتوا تولید می‌کند.
  • classic_use_case_generate_choice_board
    Classroom: کاربر روی دکمه «تولید» در صفحه «ساختن تابلو انتخاب» کلیک می‌کند که براساس پایه، موضوع، و مطالب آموزشی واردشده، تابلویی از تمرین‌های نمونه برای محصلین تولید می‌کند.
  • classic_use_case_generate_common_misconceptions
    Classroom: کاربر روی دکمه «تولید» در صفحه «مقابله با تصورات غلط رایج» کلیک می‌کند، که فهرستی از مشکلات رایجی را که محصلین با آن مواجه هستند براساس پایه تحصیلی و موضوع ورودی تولید می‌کند.
  • classic_use_case_generate_feedback
    Classroom: کاربر روی «کمک گرفتن در نوشتن» در صفحه نمره‌دهی تکلیف کلیک می‌کند، که براساس نمره ورودی و موضوع بازخورد، نظری درباره کار ارسالی محصل تولید می‌کند.
  • classic_use_case_generate_hooks
    Classroom: کاربر روی دکمه «تولید» در صفحه «ایجاد قلاب جذاب» کلیک می‌کند، که براساس پایه، درس، و مطالب آموزشی واردشده، تمرین کوتاهی برای محصل تولید می‌کند.
  • classic_use_case_generate_informative_articles
    Classroom: کاربر روی دکمه «تولید» در صفحه «نوشتن نوشتار اطلاعاتی» کلیک می‌کند، که نوشتاری را تولید می‌کند که موضوع ورودی را توصیف می‌کند و برای مقطع تحصیلی ورودی مناسب است.
  • classic_use_case_generate_lesson_plan
    Classroom: کاربر روی دکمه «تولید طرح درس» کلیک می‌کند، که طرح درسی را براساس پایه، موضوع، و مطالب آموزشی ورودی تولید می‌کند.
  • classic_use_case_generate_presentation
    Classroom: کاربر روی دکمه «تولید طرح کلی ارائه» کلیک می‌کند که براساس نمره، موضوع، و طول ارائه واردشده، یک ارائه «اسلایدنگار» تولید می‌کند.
  • classic_use_case_generate_project_activities
    Classroom: کاربر روی دکمه «تولید پروژه» کلیک می‌کند و چندین ایده پروژه فردی یا گروهی براساس مقطع تحصیلی، موضوع، و مطالب آموزشی ورودی تولید می‌شود.
  • classic_use_case_generate_questions
    Classroom: کاربر روی دکمه «تولید سؤالات» کلیک می‌کند که براساس پایه تحصیلی، موضوع، و نوع سؤال واردشده، فهرستی از سؤالات تولید می‌کند.
  • classic_use_case_generate_rubric
    Classroom: کاربر روی دکمه «تولید معیارها» در صفحه «ایجاد سیستم نمره‌دهی» کلیک می‌کند، که سیستم نمره‌دهی را براساس نمره ورودی، سطح عملکرد، و دستورالعمل‌های تکلیف تولید می‌کند.
  • classic_use_case_generate_story
    Classroom: کاربر روی دکمه «تولید» در صفحه «نوشتن داستان» کلیک می‌کند، که براساس کلاس، موضوع، و کلیدواژه‌های ورودی، داستان کوتاهی تولید می‌کند.
  • classic_use_case_generate_text_dependent_questions
    Classroom: کاربر روی دکمه «تولید سؤالات» در صفحه «توسعه دادن پرسش‌های درک مطلب» کلیک می‌کند، که فهرستی از سؤالات را براساس پایه تحصیلی، نوع سؤال، مهارت‌های خواندن، و پیام‌واره نوشتاری ورودی تولید می‌کند.
  • classic_use_case_generate_vocab_list
    Classroom: کاربر روی دکمه «تولید کردن» در «ایجاد فهرست واژگان» کلیک می‌کند، که فهرستی از واژگان و تعاریف را براساس پایه تحصیلی، موضوع، و مطالب آموزشی ورودی تولید می‌کند.
  • 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
    Classroom: کاربر روی دکمه «تولید» در صفحه «تغییر سطح نوشتار» کلیک می‌کند، که نسخه به‌روزشده‌ای از نوشتار مشخص‌شده او را تولید می‌کند که برای پایه ورودی مناسب است.
  • classic_use_case_sheets_turbofill
    «کاربرگ‌نگار»: کاربر پیشنهاد پیش‌کنشی را برای پر کردن ستونی با داده‌های نوشتاری براساس ستون دیگری در جدول می‌پذیرد.
  • classic_use_case_suggest_time_reporting
    Gmail: کاربر پیشنهاد تولیدشده با Gemini را برای زمان پیشنهادی هنگام زمان‌بندی جلسه بااستفاده از «کمک گرفتن در زمان‌بندی» درحین نوشتن ایمیل پذیرفت.
  • classic_use_case_teleprompter_word_match
    Vids: برای نوشتارنمای هوشمند «استودیوِ ضبط» استفاده می‌شود تا بااستفاده از مدل گفتار به نوشتار، کلمات متن را با گفتار کاربر به‌طور هم‌زمان مطابقت دهد.
  • classic_use_case_translate_text
    Classroom: کاربر روی دکمه «ترجمه» در صفحه «ترجمه نوشتار» کلیک می‌کند و نوشتار ورودی به زبان انتخابی ترجمه می‌شود.
  • condense
    • ‫Gmail: وقتی کاربر روی «کوتاه کردن» در منو پالایش کلیک می‌کند، محتوای پیش‌نویس را کوتاه می‌کند.
    • ‫Slides: با دکمه «کوتاه کردن» در نقطه ورودی «کمک گرفتن در نوشتن» در زیر چارگوش نوشتاری مطابقت دارد. ‫Gemini نسخه کوتاه‌شده‌ای از چارگوش نوشتار انتخاب‌شده را برمی‌گرداند.
    .
  • conversation
    پیام‌واره‌ای به پانل کناری Gemini ارسال می‌شود. این کار می‌تواند مستقیماً توسط کاربر یا توسط ویژگی دیگری ازطرف کاربر شروع شود (برای مثال، پیشنهاد روی شبکه).
  • custom_prompt
    اسلایدنگار: با ورودی «اصلاح با پیام‌واره» در نقطه ورودی «کمک گرفتن در نوشتن» در زیر چارگوش نوشتاری مطابقت دارد. ‫Gemini نسخه بازنویسی‌شده‌ای از چارگوش نوشتار انتخاب‌شده را براساس پیام‌واره کاربر برمی‌گرداند.
  • describe_gemini_uses
    • گپ: کاربردهای Gemini را در بافت در قاب کناری شرح می‌دهد.
    • Meet: "What can Gemini do in Google Meet" in Side Panel.
    • «کاربرگ‌نگار»: کاربر از Gemini می‌خواهد قابلیت‌هایش را شرح دهد یا روش‌هایی برای استفاده از این ویژگی پیشنهاد دهد.
    .
  • elaborate
    Gmail: وقتی کاربر روی «توضیح دادن» در منو پالایش کلیک می‌کند، محتوای پیش‌نویس را بسط می‌دهد.
  • formalize
    • ‫Gmail: وقتی کاربر روی «رسمی کردن» در منو پالایش کلیک می‌کند، محتوای پیش‌نویس را رسمی می‌کند.
    • اسلایدنگار: با دکمه «رسمی‌تر» در نقطه ورودی «کمک گرفتن در نوشتن» در زیر چارگوش نوشتاری مطابقت دارد. ‫Gemini نسخه بازنویسی‌شده‌ای از چارگوش نوشتاری انتخاب‌شده را که لحن رسمی‌تری دارد برمی‌گرداند.
    .
  • generate_ai_function_response
    «کاربرگ‌نگار»: Gemini مستقیماً در سلول یا محدوده محتوا تولید می‌کند. این زمانی فعال می‌شود که کاربر به‌طور دستی تابع ()AI =را وارد کند یا از ویژگی‌ای استفاده کند که ازطرف او محتوا در جدول تولید می‌کند.
  • generate_avatar_video
    Vids: وقتی کاربر متنی ارائه می‌دهد و روی «تولید کردن» در نوار کناری چهرک هوش مصنوعی کلیک می‌کند، ویدیویی از چهرک دیجیتال تولید می‌کند.
  • generate_document
    • Vids: براساس پیام‌واره، فایل‌های پیوست‌شده، طرح کلی تولیدشده، و الگوی پشتیبانی‌شده از کادر گفتگوی «شروع به کار»، Google Vid تولید می‌کند.
    • اسلایدنگار: ازطریق کادر گفتگوی «شروع به کار»، براساس پیام‌واره و هر منبع و سبک ارائه‌شده، مجموعه اسلایدنگار Google تولید می‌کند.
    .
  • 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
    ‫Gemini پیام‌واره‌های آغازگر پیشنهادی را برای کاربران تولید می‌کند که از بافت فعال استفاده می‌کند.
  • generate_starter_freeform
    وقتی روی کاشی‌های شروع کلیک می‌شود، پاسخ تولید می‌کند.
  • generate_starter_tile_prompts
    ‫Gemini پیام‌واره‌های آغازگر اولیه و نیمه‌زمینه‌ای را به‌صورت کاشی در پانل کناری نمایش می‌دهد تا به کاربران کمک کند شروع کنند.
  • generate_table_name
    «کاربرگ‌نگار»: Gemini به‌طور خودکار نام جدول را (براساس محتوای جدول) برای جدول جدیدی که از پیشنهاد تبدیل جدول تبدیل شده است اضافه می‌کند.
  • generate_text
    Gmail: وقتی کاربر روی «ایجاد» در ورودی پیام‌واره «کمک گرفتن در نوشتن» کلیک می‌کند، پیش‌نویس هوشمندی تولید می‌کند.
  • generate_videos_in_product
    Vids: وقتی کاربر پیام‌واره نوشتاری در نوار کناری «کلیپ ویدیویی هوش مصنوعی» وارد می‌کند، ویدیو تولید می‌کند.
  • live_generate_document
    سندنگار: تولید سند از مکالمه زنده با کاربر.
  • outpaint
    Vids: وقتی کاربر در پیام‌واره‌اش درخواست برون‌نقاشی می‌کند و در نوار کناری «تولید تصویر» روی «ایجاد» کلیک می‌کند، نسخه گسترش‌یافته‌ای از تصویر انتخاب‌شده تولید می‌کند که فراتر از مرزهای اصلی آن است.
  • paraphrase
    اسلایدنگار: با دکمه «بازنویسی» در نقطه ورودی «کمک گرفتن در نوشتن» در زیر چارگوش نوشتاری مطابقت دارد. ‫Gemini نوشتار انتخاب‌شده را با واژه‌هایی متفاوت بازنویسی می‌کند.
  • proactive_daily_briefs
    خلاصه روزانه پیش‌کنشگرانه‌ای برای کاربر در Chat تولید می‌کند.
  • proactive_suggestions
    نوشتار را برای کاشی‌های پیشنهاد پیش‌کنشی براساس بافت تولید می‌کند.
  • proactive_suggestions_response
    کاربر پیشنهاد پیش‌کنشی را برای امتحان کردن در پانل کناری Gemini انتخاب کرد و پاسخی تولید شد.
  • proofread
  • remove_background
    Vids: وقتی کاربر روی دکمه «برداشتن پس‌زمینه» در نوارابزار شناور تصویر کلیک می‌کند، پس‌زمینه را از تصویر انتخاب‌شده برمی‌دارد و آن را شفاف می‌کند.
  • replace_background
    Vids: وقتی کاربر پیام‌واره‌ای برای توصیف پس‌زمینه جدید ارائه می‌دهد و روی «ایجاد» در نوار کناری «تولید تصویر» کلیک می‌کند، پس‌زمینه تصویر انتخاب‌شده را جایگزین می‌کند.
  • search_web
    کاربر بااستفاده از پانل کناری Gemini در وب جستجو کرد.
  • suggest_time
    تقویم: پیشنهادهای زمان درخواست‌شده برای جلسه.
  • summarize
    ‫Gemini بافت فعلی را خلاصه می‌کند.
  • summarize_document_comment_thread
    خلاصه کردن رشته نظرات در سند.
  • summarize_drive_homepage_doclist_files
    خلاصه کوتاهی از فایل را به‌صورت درون‌خطی در فهرست فایل «صفحه اصلی Drive» نشان می‌دهد.
  • summarize_drive_homepage_doclist_files_long
    وقتی کاربر روی «دیدن جزئیات» در فهرست فایل صفحه اصلی Drive کلیک می‌کند، خلاصه فایل طولانی‌تری نشان می‌دهد.
  • summarize_file
    گپ: وقتی کاربر روی دکمه خلاصه کردن در کارت پیش‌نمایش فایل 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
  • notebooklm
    ‫Gemini Notebook.
  • 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

مشخص می‌کند که تعامل هوش مصنوعی زایا از کجا در میانای کاربر آغاز می‌شود. مقادیر احتمالی:

  • ai_function
  • ask_gemini
    از Gemini در Chat بپرسید.
  • 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}