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