Class ScriptProperties

ScriptProperties

הוצא משימוש. המחלקה הזו הוצאה משימוש ולא כדאי להשתמש בה בסקריפטים חדשים.

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

שיטות שהוצאו משימוש

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

שיטות שהוצאו משימוש

deleteAllProperties()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ולא כדאי להשתמש בה בסקריפטים חדשים.

מחיקת כל הנכסים.

ScriptProperties.deleteAllProperties();

חזרה

ScriptProperties – האובייקט הזה, לשרשור

ראה גם

• deleteProperty(key)

---

deleteProperty(key)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ולא כדאי להשתמש בה בסקריפטים חדשים.

מחיקת הנכס עם המפתח הנתון.

ScriptProperties.deleteProperty('special');

פרמטרים

שם	סוג	תיאור
key	String	מפתח לנכס למחיקה

חזרה

ScriptProperties – האובייקט הזה, לשרשור

ראה גם

• deleteAllProperties()

---

getKeys()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ולא כדאי להשתמש בה בסקריפטים חדשים.

כדאי להשיג את כל המפתחות הזמינים.

חזרה

String[]

---

getProperties()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ולא כדאי להשתמש בה בסקריפטים חדשים.

גישה לכל הנכסים הזמינים בבת אחת.

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

ScriptProperties.setProperties({
  "cow"     : "moo",
  "sheep"   : "baa",
  "chicken" : "cluck"
});

// Logs "A cow goes: moo"
Logger.log("A cow goes: %s", ScriptProperties.getProperty("cow"));

// This makes a copy. Any changes that happen here will not
// be written back to properties.
var animalSounds = ScriptProperties.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 – עותק של המאפיינים שמכילים צמדי מפתח/ערך

---

getProperty(key)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ולא כדאי להשתמש בה בסקריפטים חדשים.

מחזירה את הערך שמשויך למפתח שצוין, או הערך null אם אין ערך.

var specialValue = ScriptProperties.getProperty('special');

פרמטרים

שם	סוג	תיאור
key	String	המפתח לערך שצריך לאחזר

חזרה

String – הערך שמשויך למפתח

ראה גם

• setProperty(key, value)

---

setProperties(properties)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ולא כדאי להשתמש בה בסקריפטים חדשים.

מגדיר בכמות גדולה את כל המאפיינים הנלקחים מהאובייקט הנתון.

ScriptProperties.setProperties({special: 'sauce', 'meaning': 42});

פרמטרים

שם	סוג	תיאור
properties	Object	אובייקט שמכיל את המאפיינים להגדרה.

חזרה

ScriptProperties – האובייקט הזה, לשרשור

ראה גם

• setProperty(key, value)

---

setProperties(properties, deleteAllOthers)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ולא כדאי להשתמש בה בסקריפטים חדשים.

מגדיר בכמות גדולה את כל המאפיינים הנלקחים מהאובייקט הנתון.

// This deletes all other properties
ScriptProperties.setProperties({special: 'sauce', 'meaning': 42}, true);

פרמטרים

שם	סוג	תיאור
properties	Object	אובייקט שמכיל את המאפיינים להגדרה.
deleteAllOthers	Boolean	האם למחוק את כל הנכסים הקיימים.

חזרה

ScriptProperties – האובייקט הזה, לשרשור

ראה גם

• setProperty(key, value)

---

setProperty(key, value)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ולא כדאי להשתמש בה בסקריפטים חדשים.

שומר על הערך שצוין עם המפתח שסופק. כל ערך קיים שמשויך לערך הזה יוחלף.

ScriptProperties.setProperty('special', 'sauce');

פרמטרים

שם	סוג	תיאור
key	String	מפתח לנכס
value	String	לשיוך למפתח

חזרה

ScriptProperties – האובייקט הזה, לשרשור

ראה גם

• getProperty(key)