שירות המאפיינים מאפשר לאחסן נתונים פשוטים בצמדי מפתח/ערך בהיקף של סקריפט אחד, משתמש אחד של סקריפט, או מסמך אחד שבו נעשה שימוש בתוסף. זה כן המשמשים בדרך כלל לאחסון הגדרות המפתח או העדפות המשתמש. מאפיינים אף פעם לא משותפים בין סקריפטים.
כדי לראות את המכסות היומיות ואת מגבלות האחסון של השירות 'נכסים': מכסות לשירותי Google.
השוואה בין חנויות נכסים
PropertiesService
שאובייקט גלובלי מציע שלוש שיטות, שכל אחת מהן מחזירה
Properties
אבל עם הרשאות גישה שונות, כפי שמוצג בטבלה הבאה:
מאפייני הסקריפט | מאפייני המשתמש | מאפייני המסמך | |
---|---|---|---|
שיטת גישה | getScriptProperties() |
getUserProperties() |
getDocumentProperties() |
נתונים שמשותפים בין | כל המשתמשים בסקריפט, בתוסף או באפליקציית אינטרנט | המשתמש הנוכחי בסקריפט, בתוסף או באפליקציית אינטרנט | כל המשתמשים בתוסף במסמך הפתוח |
בדרך כלל משמש עבור | נתוני תצורה ברמת האפליקציה, כמו שם המשתמש והסיסמה של מסד הנתונים החיצוני של המפתח | הגדרות ספציפיות למשתמש, כמו יחידות מטריות או יחידות אימפריאליות | נתונים ספציפיים למסמך, כמו כתובת ה-URL של המקור של תרשים מוטמע |
פורמט נתונים
שירות המאפיינים מאחסן את כל הנתונים כמחרוזות בצמדי מפתח/ערך. סוגי נתונים שעדיין אינן מחרוזות מומרות באופן אוטומטי למחרוזות, כולל methods שכלולות באובייקטים שנשמרו.
מתבצעת שמירה של הנתונים
כדי לשמור ערך בודד, קוראים לשיטה Properties.setProperty(key,
value)
של החנות המתאימה, כפי שמוצג בדוגמה הבאה:
כדי לשמור נתונים בכמות גדולה, יש להעביר מפה של צמדי מפתח/ערך אל
Properties.setProperties(properties)
כל צמד מפתח/ערך של אובייקט בפרמטר מאוחסן בתור
נכס:
קריאת נתונים
כדי לאחזר ערך בודד ששמרתם בעבר, צריך להתקשר
Properties.getProperty(key)
כדי לאחזר את כל הערכים במאגר הנכסים הנוכחי, קוראים לפונקציה
Properties.getProperties()
שינוי נתונים
השיטות getProperty()
ו-getProperties()
מחזירות עותק של
של הנתונים, ולא צפייה פעילה, לכן שינוי האובייקט המוחזר לא יעדכן את הערך
בחנות הנכסים. כדי לעדכן את הנתונים בחנות, יש לשמור אותם שוב:
מחיקת נתונים
כדי למחוק ערך בודד,
Properties.deleteProperty(key)
כדי למחוק את כל הנכסים בחנות הנוכחית, התקשר
Properties.deleteAllProperties()
ניהול מאפייני סקריפט באופן ידני
אפשר להוסיף באופן ידני עד 50 מאפיינים מותאמים אישית, בתור מחרוזות במפתח-ערך בדף הגדרות הפרויקט. כדי להוסיף יותר מחמישים נכסים, להוסיף אותם באופן פרוגרמטי באמצעות השיטות שתוארו למעלה שמירת נתונים. כשמגדירים מאפייני סקריפטים בדף הגדרות הפרויקט, אי אפשר משתנים של סקריפט עזר.
הוספת מאפייני סקריפט
- פותחים את פרויקט Apps Script.
- בצד ימין, לוחצים על הגדרות הפרויקט
.
- כדי להוסיף את הנכס הראשון, בקטע מאפייני סקריפט לוחצים על מוסיפים את מאפיין הסקריפט.
- כדי להוסיף מאפיין שני ומאפיינים נוספים, בקטע מאפייני סקריפט לוחצים על עריכת מאפייני סקריפט > הוספת מאפיין סקריפט.
- בשדה נכס, מזינים את שם המפתח.
- בשדה Value, מזינים את ערך המפתח.
- (אופציונלי) כדי להוסיף עוד מאפיינים, לוחצים על הוספת מאפיין סקריפט.
- לוחצים על Save script properties (שמירת מאפייני הסקריפט).
עריכת מאפייני הסקריפט
- פותחים את פרויקט Apps Script.
- בצד ימין, לוחצים על הגדרות הפרויקט
.
- בקטע מאפייני סקריפט, לוחצים על עריכת מאפייני סקריפט.
- עורכים שינויים בשם המפתח ובערך המפתח בכל נכס שרוצים לשנות.
- לוחצים על Save script properties (שמירת מאפייני הסקריפט).
מחיקת מאפייני סקריפט
- פותחים את פרויקט Apps Script.
- בצד ימין, לוחצים על הגדרות הפרויקט
.
- בקטע מאפייני סקריפט, לוחצים על עריכת מאפייני סקריפט.
- לצד הנכס שרוצים למחוק, לוחצים על סמל ההסרה .
- לוחצים על Save script properties (שמירת מאפייני הסקריפט).