Properties Service

נכסים

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

שיעורים

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

Properties

Methods

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

PropertiesService

Methods

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

ScriptProperties

UserProperties