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)