הוצא משימוש. הסיווג הזה הוצא משימוש ואין להשתמש בו בסקריפטים חדשים.
מאפייני משתמש הם צמדים של מפתח/ערך שייחודיים למשתמש. ההיקף של מאפייני משתמש הוא לכל משתמש. כל סקריפט שפועל תחת הזהות של משתמש יכול לגשת למאפייני המשתמש של אותו משתמש בלבד.
שיטות שהוצאו משימוש
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
| | מחיקת כל הנכסים. |
| | מוחק את הנכס עם המפתח שצוין. |
| String[] | קבלת כל המפתחות הזמינים. |
| Object | קבלת כל הנכסים הזמינים בבת אחת. |
| String|null | הפונקציה מחזירה את הערך שמשויך למפתח שצוין, או null אם לא קיים ערך כזה. |
| | הפונקציה קובעת את כל המאפיינים שנלקחים מהאובייקט הנתון. |
| | הפונקציה קובעת את כל המאפיינים שנלקחים מהאובייקט הנתון. |
| | הפונקציה שומרת את הערך שצוין בפרמטר in עם המפתח שצוין. |
שיטות שהוצאו משימוש
delete All Properties()
delete All Properties()הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.
מחיקת כל הנכסים.
UserProperties .deleteAllProperties();
חזרה
– האובייקט הזה, לשרשורUser
ראה גם
delete Property(key)
delete Property(key)הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.
מוחק את הנכס עם המפתח שצוין.
UserProperties .deleteProperty('special');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
key | String | המפתח של הנכס למחיקה |
חזרה
– האובייקט הזה, לשרשורUser
ראה גם
get Keys()
get Keys()הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.
קבלת כל המפתחות הזמינים.
חזרה
String[]
get Properties()
get Properties()הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.
קבלת כל הנכסים הזמינים בבת אחת.
הפעולה הזו מחזירה עותק ולא תצוגה פעילה, כך ששינוי המאפיינים באובייקט שמוחזר לא יעדכן אותם באחסון, ולהפך.
UserProperties .setProperties({ "cow" : "moo", "sheep" : "baa", "chicken" : "cluck" }); // Logs "A cow goes: moo" Logger.log("A cow goes: %s", UserProperties.getProperty("cow")); // This makes a copy. Any changes that happen here will not // be written back to properties. var animalSounds = UserProperties.getProperties(); // Logs: // A chicken goes cluck! // A cow goes moo! // A sheep goes baa! for(var kind in animalSounds) { Logger.log("A %s goes %s!", kind, animalSounds[kind]); }
חזרה
Object – עותק של המאפיינים שמכילים צמדי מפתח/ערך
get Property(key)
get Property(key)הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.
הפונקציה מחזירה את הערך שמשויך למפתח שצוין, או null אם לא קיים ערך כזה.
const specialValue = UserProperties.getProperty('special');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
key | String | המפתח של הערך שרוצים לאחזר |
חזרה
String|null – הערך שמשויך למפתח
ראה גם
set Properties(properties)
set Properties(properties)הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.
הפונקציה קובעת את כל המאפיינים שנלקחים מהאובייקט הנתון.
UserProperties .setProperties({special: 'sauce', 'meaning': 42});
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
properties | Object | אובייקט שמכיל את המאפיינים להגדרה. |
חזרה
– האובייקט הזה, לשרשורUser
ראה גם
set Properties(properties, deleteAllOthers)
set Properties(properties, deleteAllOthers)הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.
הפונקציה קובעת את כל המאפיינים שנלקחים מהאובייקט הנתון.
// This deletes all other properties UserProperties.setProperties({special: 'sauce', 'meaning': 42}, true);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
properties | Object | אובייקט שמכיל את המאפיינים להגדרה. |
delete | Boolean | האם למחוק את כל המאפיינים הקיימים. |
חזרה
– האובייקט הזה, לשרשורUser
ראה גם
set Property(key, value)
set Property(key, value)הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.
הפונקציה שומרת את הערך שצוין בפרמטר in עם המפתח שצוין. כל ערך קיים שמשויך למפתח הזה יוחלף.
UserProperties .setProperty('special', 'sauce');
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
key | String | מפתח של מאפיין |
value | String | הערך שרוצים לשייך למפתח |
חזרה
– האובייקט הזה, לשרשורUser