מאפשר לסקריפטים לאחסן נתונים פשוטים בצמדי מפתח/ערך שמוגבלים לסקריפט אחד, למשתמש אחד של סקריפט או למסמך אחד שבו נעשה שימוש בתוסף. אי אפשר לשתף מאפיינים בין סקריפטים. מידע נוסף על מקרים שבהם כדאי להשתמש בכל סוג של נכס זמין במדריך לשירות הנכסים.
// 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 | מחזירה מאגר נכסים שרק המשתמש הנוכחי או המשתמש בפועל יכולים לגשת אליו, ורק בסקריפט הזה. |
תיעוד מפורט
getDocumentProperties()
מקבלים מאגר נתונים של נכס (רק עבור הסקריפט הזה) שכל המשתמשים יכולים לגשת אליו במסמך, בגיליון האלקטרוני או בטופס הפתוחים. היא זמינה רק אם הסקריפט פורסם ומופעל כתוסף, או אם הוא מקשר לסוג קובץ של Google. אם מאפייני המסמך לא זמינים, השיטה הזו מחזירה null. אי אפשר לגשת למאפייני מסמך שנוצרו על ידי סקריפט מחוץ לסקריפט הזה, גם לא על ידי סקריפטים אחרים שניגשים לאותו מסמך.
חזרה
Properties — חנות מאפיינים רק לסקריפט הזה, שכל המשתמשים במסמך הנוכחי יכולים לגשת אליה, או null אם הסקריפט הוא לא תוסף ולא מקושר לקובץ Google Workspace.
getScriptProperties()
מקבלים מאגר נתונים של נכס שכל המשתמשים יכולים לגשת אליו, אבל רק בתוך הסקריפט הזה.
חזרה
Properties – מאגר מאפיינים שכל המשתמשים בסקריפט יכולים לגשת אליו.
getUserProperties()
מחזירה מאגר נכסים שרק המשתמש הנוכחי או המשתמש בפועל יכולים לגשת אליו, ורק בסקריפט הזה.
חזרה
Properties — מאגר נכסים שרק המשתמש הנוכחי או המשתמש בפועל של הסקריפט יכול לגשת אליו.