Class 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	שמירת הערך שצוין ב-in במפתח שסופק.

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

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 אם אין ערך כזה.

const 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)

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

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

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

פרמטרים

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

חזרה

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

ראה גם

• getProperty(key)