היקפי הרשאות ואישורים של OAuth לשלבים ברצף פעולות ב-Workspace Studio

כשאתם יוצרים ומפעילים תהליכים אוטומטיים ב-Google Workspace Studio, האבטחה ופרטיות הנתונים מובנות כברירת מחדל. ‫Workspace Studio משתמש במודל זהות עם הרשאות מינימליות. כלומר, תהליכים אוטומטיים מריצים משימות ברקע רק עם ההרשאות המינימליות שנדרשות כדי לבצע כל פעולה, במקום לקבל גישה רחבה ובלתי מוגבלת לכל חשבון Google של המשתמש.

כדי להגדיר את האוטומציה בצורה בטוחה ולשמור על הרשאות הגישה לנתונים של הארגון, אתם יכולים להיעזר במדריך הזה כדי לזהות את ההרשאות שנדרשות לכל שלב בתהליך. בדף הזה מפורטים כל סוגי השלבים בתהליך והיקפי ההרשאות הנדרשים ל-OAuth.

איך היקפי ההרשאות של OAuth משפיעים על השימוש ב-Studio

כשאתם משתמשים ב-Workspace Studio, היקפי ההרשאות של OAuth משפיעים על הדרכים שבהן אתם יוצרים, מפעילים ומנהלים את התהליכים שלכם:

  • הרשאה חד-פעמית: בפעם הראשונה שמוסיפים שלב שיוצר אינטראקציה עם שירות של Google (כמו Gmail או Google Drive), מופיעה הודעת אימות מ-Google. הפעולה הזו מאשרת את ההיקף הספציפי של השלב הזה, כדי שהתהליך יוכל לפעול באופן עצמאי ברקע.
  • הפעלה אסינכרונית ברקע: אחרי שמפעילים תהליך, הוא פועל באופן אסינכרוני בתשתית של Google. התהליך מבצע משימות (כמו קביעת אירוע ביומן או כתיבת טיוטה) רק באמצעות ההיקפים הספציפיים שאישרתם, גם כשאתם לא מחוברים באופן פעיל.
  • פיקוח אדמין מרכזי: אדמינים יכולים לראות את כל התהליכים הפעילים בארגון באמצעות ההגדרות של ניהול הרשאות הגישה של הנציגים במסוף Admin. כדי להגן על הנתונים של הארגון, אתם יכולים להשהות תהליכים ספציפיים או להגדיר טירגוט ולהגביל היקפי הרשאות OAuth ספציפיים (למשל, להסיר את הגישה ל-Drive ולהשאיר את Gmail פעיל). מידע נוסף

פתרון בעיות שקשורות להרשאות לא מספיקות

אם תהליך עבודה לא פועל ומוצגת השגיאה "אין מספיק הרשאות" או "משהו השתבש" ביומן הפעילות, צריך לבדוק את הדברים הבאים:

  • לתת הרשאה מחדש לתהליך העבודה: פותחים את תהליך העבודה בכלי ליצירת תהליכים, לוחצים על שמירת השינויים ופועלים לפי ההנחיות בתיבת ההרשאה כדי לרענן אסימוני OAuth שפג תוקפם או שחסרים.
  • חסימות של בקרת גישה מבוססת-הקשר (CAA): אם הארגון שלכם אוכף באופן קפדני את כללי המדיניות לגבי מכשירים או כתובות IP, לפעמים יכולות להיות חסימות של הפעלות תהליכים ברקע. מוודאים שמזהה הלקוח של Workspace Studio פטור מהגבלות ה-CAA.

שלבי התהליך והיקפי ההרשאות הנדרשים של OAuth

בטבלה הזו מפורטים השלבים הרגילים ב-Workspace Studio והיקפי ההרשאות של OAuth שכל שלב צריך כדי לפעול מאחורי הקלעים.

שם השלב הגדרות והיקף
שלבים ב-Studio AI
פרימיטיבים של AIP (למשל Ask Gemini, ‏ Ask a Gem, ‏ Create with Gemini, ‏ Deep Research, ‏ Recap unread emails, ‏ Extract, ‏ Decide, ‏ Summarize) https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/cloud_search.query
כללי וכלי עזר
לפי לוח זמנים לא רלוונטי
שליחת webhook לא רלוונטי – צד ג'
בדיקה: לא רלוונטי – לוגיקה פנימית
סינון רשימה לא רלוונטי – לוגיקה פנימית
Gmail
כשמתקבל אימייל https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.event_trigger https://www.googleapis.com/auth/workspace.workflows.trigger 
אני רוצה לקבל התראה באימייל https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
שליחת אימייל https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
לכתוב טיוטה של אימייל https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
העברת אימייל https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
ניסוח תשובה https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
שליחת תשובה לאימייל https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
הוספה או הסרה של תוויות https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
סימון הודעות כ"כבר קראתי" או "עוד לא קראתי" https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
סימון בכוכב או ביטול הסימון בכוכב https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
העברה לארכיון (או מחיקה) https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Google Chat
כשמישהו מצטרף למרחב https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
כשמגיעה אליי הודעה בצ'אט https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
כשמתייגים אותי https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
כשמתווספת תגובה באמוג'י https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
אני רוצה לקבל התראה ב-Chat https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships
שליחת מרחב ב-Chat https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
שליחה לאחרים https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships
מענה להודעה https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships
Google Sheets
כשיש שינוי בגיליון https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly
הוספת שורה https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
עדכון השורות https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
ניקוי שורות https://www.googleapis.com/auth/spreadsheet https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
שליפת תוכן מהגיליון https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Google Docs
יצירת מסמך ב-Google Docs https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly
הוספה למסמך https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly
יומן Google ו-Tasks
על סמך פגישה https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/calendar.events.readonly 
יצירת משימה https://www.googleapis.com/auth/tasks
יצירת אירוע https://www.googleapis.com/auth/calendar.events
הוספת משתתפים https://www.googleapis.com/auth/calendar.events
Google Drive
כשפריט מתווסף לתיקייה https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly
כשמתבצעת עריכה של קובץ https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
כשמתבצעת עריכה של פריט בתיקייה https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly
העברת הקובץ https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
העתקת הקובץ https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
שמירת קבצים מצורפים https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
יצירת תיקייה https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Google Meet
כשסיכום הפגישה https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.meet.readonly https://www.googleapis.com/auth/meetings.space.created https://www.googleapis.com/auth/calendar.events.readonly https://www.googleapis.com/auth/meetings.space.readonly
Google Forms
כשמתקבלת תשובה לטופס https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/forms.responses.readonly https://www.googleapis.com/auth/forms.body.readonly https://www.googleapis.com/auth/drive.readonly (רק לתמיכה בקובצי DLP ב-Forms)
NotebookLM
הוספת מקור ל-NotebookLM https://www.googleapis.com/auth/drive.readonly
שליחת שאלה ל-NotebookLM https://www.googleapis.com/auth/drive.readonly