Class PropertiesService

PropertiesService

מאפשר לסקריפטים לאחסן נתונים פשוטים בצמדי מפתח/ערך שמוגבלים לסקריפט אחד, למשתמש אחד של סקריפט או למסמך אחד שבו נעשה שימוש בתוסף. אי אפשר לשתף מאפיינים בין סקריפטים. מידע נוסף על מקרים שבהם כדאי להשתמש בכל סוג של נכס זמין במדריך לשירות הנכסים.

// 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

שיטהסוג הערך שמוחזרתיאור קצר
getDocumentProperties()Propertiesמקבלים מאגר נתונים של נכס (רק עבור הסקריפט הזה) שכל המשתמשים יכולים לגשת אליו במסמך, בגיליון האלקטרוני או בטופס הפתוחים.
getScriptProperties()Propertiesמקבלים מאגר נתונים של נכס שכל המשתמשים יכולים לגשת אליו, אבל רק בתוך הסקריפט הזה.
getUserProperties()Propertiesמחזירה מאגר נכסים שרק המשתמש הנוכחי או המשתמש בפועל יכולים לגשת אליו, ורק בסקריפט הזה.

תיעוד מפורט

getDocumentProperties()

מקבלים מאגר נתונים של נכס (רק עבור הסקריפט הזה) שכל המשתמשים יכולים לגשת אליו במסמך, בגיליון האלקטרוני או בטופס הפתוחים. היא זמינה רק אם הסקריפט פורסם ומופעל כתוסף, או אם הוא מקשר לסוג קובץ של Google. אם מאפייני המסמך לא זמינים, השיטה הזו מחזירה null. אי אפשר לגשת למאפייני מסמך שנוצרו על ידי סקריפט מחוץ לסקריפט הזה, גם לא על ידי סקריפטים אחרים שניגשים לאותו מסמך.

חזרה

Properties — חנות מאפיינים רק לסקריפט הזה, שכל המשתמשים במסמך הנוכחי יכולים לגשת אליה, או null אם הסקריפט הוא לא תוסף ולא מקושר לקובץ Google Workspace.


getScriptProperties()

מקבלים מאגר נתונים של נכס שכל המשתמשים יכולים לגשת אליו, אבל רק בתוך הסקריפט הזה.

חזרה

Properties – מאגר מאפיינים שכל המשתמשים בסקריפט יכולים לגשת אליו.


getUserProperties()

מחזירה מאגר נכסים שרק המשתמש הנוכחי או המשתמש בפועל יכולים לגשת אליו, ורק בסקריפט הזה.

חזרה

Properties — מאגר נכסים שרק המשתמש הנוכחי או המשתמש בפועל של הסקריפט יכול לגשת אליו.