ל-Apps Script נדרשת הרשאת משתמש כדי לגשת אל נתונים פרטיים מתוך בשירותי Google המובנים או שירותי Google מתקדמים.
הענקת הרשאות גישה
![](https://developers-dot-devsite-v2-prod.appspot.com/static/apps-script/images/new-auth-1.png?authuser=1&hl=he)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/apps-script/images/new-auth-2.png?authuser=1&hl=he)
Apps Script קובע את היקפי ההרשאות (כמו גישה ל-Google Sheets) או Gmail) באופן אוטומטי, בהתאם לסריקה של הקוד. הקוד שהוא עם הערות שנוספות עדיין יכולות ליצור בקשת הרשאה. אם סקריפט צריך הרשאה, תופיע אחת מתיבות הדו-שיח של ההרשאה שמוצגות כאן לרוץ.
סקריפטים שאישרת בעבר מבקשים גם להוסיף אם שינוי בקוד מוסיף שירותים חדשים. סקריפטים לא יכולים לבקש סקריפטים הרשאה אם ניגשים לסקריפט כאפליקציית אינטרנט שפועלת במסגרת זהות המשתמש של בעלי הסקריפט.
שלילת זכויות גישה
כדי לבטל את הגישה של סקריפט לנתונים שלכם, יש לפעול לפי השלבים הבאים:
- נכנסים אל הדף הרשאות לחשבון Google שלך. (כדי לנווט אל בעתיד, לבקר בכתובת Google.com, ולאחר מכן לוחצים על תמונת החשבון בפינה השמאלית העליונה של המסך. הבא, לוחצים על החשבון שלי ואז אפליקציות מקושרות & אתרים "כניסה ו אבטחה" ואז על ניהול אפליקציות.)
- לוחצים על שם הסקריפט שאת ההרשאה שלו רוצים לבטל, ולאחר מכן לוחצים על הסרה בצד שמאל, ואז על אישור בתיבת הדו-שיח שמופיעה.
הרשאות וסוגים של סקריפטים
זהות המשתמש שהסקריפט פועל איתה – וכך הנתונים שהוא יכול לגשת אליה – משתנה בהתאם לתרחיש שבו הסקריפט רץ, כפי שמוצג בטבלה שלמטה.
סוג התסריט | הסקריפט פועל כ... |
---|---|
Standalone, תוסף, או מקושר אל 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)
פועלות
מצב 'ללא הרשאה' (no-Permissions) עם כמה סיבוכים נוספים. לקבלת מידע נוסף
מידע נוסף, אפשר לעיין
מדריך למחזור החיים של ההרשאות לתוספים.
מגבלות משתמשים באפליקציות OAuth
אפליקציות שמשתמשות ב-OAuth כדי לגשת לנתוני משתמשים של Google, כולל אפליקציות פרויקטים של סקריפטים כפופים למגבלות ההרשאות. צפייה מגבלות משתמשים באפליקציית OAuth לקבלת פרטים.