Class PropertiesService

PropertiesService

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

// Sets three properties of different types.
var documentProperties = PropertiesService.getDocumentProperties();
var scriptProperties = PropertiesService.getScriptProperties();
var userProperties = PropertiesService.getUserProperties();

documentProperties.setProperty('DAYS_TO_FETCH', '5');
scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/MyWeatherService/');
userProperties.setProperty('DISPLAY_UNITS', 'metric');

שיטות

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

מסמכי תיעוד מפורטים

getDocumentProperties()

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

חזרה

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


getScriptProperties()

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

חזרה

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


getUserProperties()

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

חזרה

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