Properties Service

נכסים

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

מחלקות

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

Properties

שיטות

שיטהסוג הערך שמוחזרתיאור קצר
deleteAllProperties()Propertiesמחיקת כל הנכסים בחנות Properties הנוכחית.
deleteProperty(key)Propertiesמחיקת הנכס עם המפתח הנתון ב-מאגר הנוכחי של Properties.
getKeys()String[]קבלה של כל המפתחות מחנות Properties הנוכחית.
getProperties()Objectהפונקציה מקבלת עותק של כל צמדי המפתח/ערך בחנות Properties הנוכחית.
getProperty(key)Stringהפונקציה מקבלת את הערך שמשויך למפתח הנתון ב-Store הנוכחי ב-Properties, או ב-null אם לא קיים מפתח כזה.
setProperties(properties)Propertiesמגדיר את כל צמדי המפתח/ערך מהאובייקט הנתון ב-מאגר הנוכחי של Properties.
setProperties(properties, deleteAllOthers)Propertiesמגדירה את כל צמדי המפתח/ערך מהאובייקט הנתון ב-מאגר הנוכחי של Properties, מוחקת את כל שאר המאפיינים ב-store.
setProperty(key, value)Propertiesמגדיר את צמד המפתח/ערך הנתון ב-Store הנוכחי של Properties.

PropertiesService

שיטות

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

ScriptProperties

UserProperties