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