ל-Apps Script נדרשת הרשאת משתמש כדי לגשת למידע פרטי משירותים מובנים של Google או משירותים מתקדמים של Google.
הענקת הרשאות גישה
Apps Script קובע את היקפי ההרשאות (כמו גישה לקובצי Google Sheets או ל-Gmail) באופן אוטומטי, על סמך סריקה של הקוד. קוד שמגיבים לו עדיין יכול ליצור בקשת הרשאה. אם סקריפט זקוק להרשאה, תופיע אחת מתיבות הדו-שיח של ההרשאה שמוצגות כאן כשהוא מופעל.
גם סקריפטים שהענקתם להם הרשאה בעבר מבקשים הרשאה נוספת, אם שינוי בקוד יוסיף שירותים חדשים. סקריפטים לא יכולים לבקש הרשאה אם ניגשים לסקריפט כאפליקציית אינטרנט שפועלת במסגרת זהות המשתמש של בעלי הסקריפט.
שלילת זכויות גישה
כדי לבטל את הגישה של סקריפט לנתונים שלכם, יש לפעול לפי השלבים הבאים:
- נכנסים לדף הרשאות בחשבון Google. (כדי לנווט לדף הזה בעתיד, אתם צריכים להיכנס לכתובת Google.com וללחוץ על תמונת החשבון בפינה השמאלית העליונה של המסך. לאחר מכן לוחצים על החשבון שלי > אפליקציות ואתרים מחוברים בקטע 'כניסה ואבטחה', ואז לוחצים על ניהול אפליקציות).
- לוחצים על שם הסקריפט שאת ההרשאה שלו רוצים לבטל, ואז לוחצים על Remove משמאל, ואז על OK בתיבת הדו-שיח שנפתחת.
הרשאות וסוגים של סקריפטים
זהות המשתמש שהסקריפט פועל איתה, וכך הנתונים שהוא יכול לגשת אליה, משתנה בהתאם לתרחיש שבו הסקריפט רץ, כפי שמוצג בטבלה הבאה.
| סוג התסריט | הסקריפט פועל כ... |
|---|---|
| נפרד, תוסף או מקושר ל-Docs , Sheets , Slides או Forms | משתמש במקלדת |
| פונקציה מותאמת אישית בגיליון אלקטרוני | משתמש אנונימי; עם זאת, מגבלות המכסות נספרות בהתאם למשתמש במקלדת |
| אפליקציית אינטרנט או גאדג'ט של Google Sites | משתמש בצד הבעלים של המקלדת או הסקריפט, בהתאם לאפשרויות שנבחרו במהלך פריסת האפליקציה |
| טריגר שניתן להתקין | המשתמש שיצר את הטריגר |
היקפי הרשאות ידניות ל-Sheets, ל-Docs, ל-Slides ול-Forms
כשמפתחים תוסף או סקריפט אחר שמשתמש בשירות הגיליונות האלקטרוניים, בשירות המסמכים, בשירות Slides או בשירות Forms, אתם יכולים לאלץ את תיבת הדו-שיח של ההרשאה לבקש גישה רק לקבצים שבהם נעשה שימוש בתוסף או בסקריפט, ולא בכל הגיליונות האלקטרוניים, המסמכים או הטפסים של המשתמש. כדי לעשות זאת, צריך לכלול את הערת JsDoc הבאה בתגובה ברמת הקובץ:
/**
* @OnlyCurrentDoc
*/
הערה מנוגדת, @NotOnlyCurrentDoc, זמינה אם הסקריפט כולל ספרייה שבה מוצהר על @OnlyCurrentDoc, אבל הסקריפט הראשי למעשה דורש גישה לפריטים נוספים מלבד הקובץ הנוכחי.
מחזור החיים של ההרשאות לתוספים
תוספים ל-Google Sheets, ל-Docs, ל-Slides ול-Forms פועלים בדרך כלל לפי אותו מודל הרשאה כמו סקריפטים שמקושרים למסמך. עם זאת, בנסיבות מסוימות, הפונקציות onOpen(e) ו-onEdit(e) פועלות במצב ללא הרשאה שיש בו כמה סיבוכים נוספים. מידע נוסף מופיע במדריך למחזור החיים של הרשאות התוספים.
מגבלות משתמשים באפליקציות OAuth
אפליקציות שמשתמשות ב-OAuth כדי לגשת לנתוני המשתמשים של Google, כולל פרויקטים של Apps Script, כפופות למגבלות הרשאה. לפרטים נוספים, ראו מגבלות על משתמשים באפליקציות OAuth.