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