Class 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 — מאגר נתונים של נכס שרק המשתמש הנוכחי או המשתמש בפועל של הסקריפט יכול לגשת אליו.