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