מאפשרת לסקריפטים לאחסן נתונים פשוטים בצמדי מפתח/ערך בהיקף של סקריפט אחד, משתמש אחד של או מסמך אחד שבו נעשה שימוש בתוסף. לא ניתן לשתף מאפיינים בין סקריפטים. למידע נוסף על המקרים שבהם כדאי להשתמש בכל אחד מסוגי המאפיינים, אפשר לעיין במדריך לשירות 'מאפיינים'.
// Sets three properties of different types. var documentProperties = PropertiesService.getDocumentProperties(); var scriptProperties = PropertiesService.getScriptProperties(); var userProperties = PropertiesService.getUserProperties(); documentProperties.setProperty('DAYS_TO_FETCH', '5'); scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/MyWeatherService/'); userProperties.setProperty('DISPLAY_UNITS', 'metric');
שיטות
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
getDocumentProperties() | Properties | מקבל מאגר נכסים (עבור הסקריפט הזה בלבד) שכל המשתמשים יכולים לגשת אליו מסמך, גיליון אלקטרוני או טופס. |
getScriptProperties() | Properties | הפונקציה מקבלת מאגר נכסים שכל המשתמשים יכולים לגשת אליו, אבל רק בתוך הסקריפט הזה. |
getUserProperties() | Properties | הפונקציה מקבלת מאגר נכסים שרק המשתמש הנוכחי יכול לגשת אליו, ורק בתוך הסקריפט הזה. |
מסמכי תיעוד מפורטים
getDocumentProperties()
מקבל מאגר נכסים (עבור הסקריפט הזה בלבד) שכל המשתמשים יכולים לגשת אליו
מסמך, גיליון אלקטרוני או טופס. האפשרות הזו זמינה רק אם הסקריפט פורסם ופועל
כתוסף או אם הוא מקושר לקובץ של Google
מהסוג הזה. כשמאפייני המסמך לא זמינים, השיטה הזו מחזירה null
. מסמך
נכסים שנוצרו על ידי סקריפט לא נגישים מחוץ לסקריפט, גם לא באמצעות סקריפטים אחרים
לגשת לאותו מסמך.
חזרה
Properties
— מאגר נכסים עבור הסקריפט הזה בלבד שכל המשתמשים במסמך הנוכחי יכולים
גישה, או null
אם הסקריפט אינו תוסף או מקושר
קובץ של Workspace
getScriptProperties()
הפונקציה מקבלת מאגר נכסים שכל המשתמשים יכולים לגשת אליו, אבל רק בתוך הסקריפט הזה.
חזרה
Properties
- מאגר נכסים שכל המשתמשים בסקריפט יכולים לגשת אליו
getUserProperties()
הפונקציה מקבלת מאגר נכסים שרק המשתמש הנוכחי יכול לגשת אליו, ורק בתוך הסקריפט הזה.
חזרה
Properties
– מאגר נכסים שרק המשתמש הנוכחי של הסקריפט יכול לגשת אליו