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