Class ScriptProperties

ScriptProperties

Veraltet. Diese Klasse wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Script-Properties sind Schlüssel/Wert-Paare, die von einem Script in einem nichtflüchtigen Speicher gespeichert werden. Script-Eigenschaften gelten pro Script, unabhängig davon, welcher Nutzer das Script ausführt.

MethodeRückgabetypKurzbeschreibung
deleteAllProperties()ScriptPropertiesAlle Properties werden gelöscht.
deleteProperty(key)ScriptPropertiesLöscht die Property mit dem angegebenen Schlüssel.
getKeys()String[]Alle verfügbaren Schlüssel abrufen
getProperties()ObjectAlle verfügbaren Properties auf einmal abrufen
getProperty(key)StringGibt den mit dem angegebenen Schlüssel verknüpften Wert zurück. Wenn kein solcher Wert vorhanden ist, wird „null“ zurückgegeben.
setProperties(properties)ScriptPropertiesHiermit werden alle Eigenschaften des angegebenen Objekts im Bulk-Verfahren festgelegt.
setProperties(properties, deleteAllOthers)ScriptPropertiesHiermit werden alle Eigenschaften des angegebenen Objekts im Bulk-Verfahren festgelegt.
setProperty(key, value)ScriptPropertiesSpeichert den angegebenen Wert mit dem angegebenen Schlüssel.

Eingestellte Methoden

Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Alle Properties werden gelöscht.

ScriptProperties.deleteAllProperties();

Rückflug

ScriptProperties – dieses Objekt, zum Verketten

Weitere Informationen


Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Löscht die Property mit dem angegebenen Schlüssel.

ScriptProperties.deleteProperty('special');

Parameter

NameTypBeschreibung
keyStringSchlüssel für die zu löschende Property

Rückflug

ScriptProperties – dieses Objekt, zum Verketten

Weitere Informationen


Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Alle verfügbaren Schlüssel abrufen

Rückflug

String[]


Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Alle verfügbaren Properties auf einmal abrufen

Es wird also eine Kopie und keine Liveansicht zurückgegeben. Wenn Sie die Eigenschaften des zurückgegebenen Objekts ändern, werden sie nicht im Speicher aktualisiert und umgekehrt.

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]);
}

Rückflug

Object: eine Kopie der Properties, die Schlüssel/Wert-Paare enthalten


Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Gibt den mit dem angegebenen Schlüssel verknüpften Wert zurück. Wenn kein solcher Wert vorhanden ist, wird „null“ zurückgegeben.

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

Parameter

NameTypBeschreibung
keyStringSchlüssel für den abzurufenden Wert

Rückflug

String: Der mit dem Schlüssel verknüpfte Wert.

Weitere Informationen


Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Hiermit werden alle Eigenschaften des angegebenen Objekts im Bulk-Verfahren festgelegt.

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

Parameter

NameTypBeschreibung
propertiesObjectein Objekt mit den zu setzenden Eigenschaften.

Rückflug

ScriptProperties – dieses Objekt, zum Verketten

Weitere Informationen


Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Hiermit werden alle Eigenschaften des angegebenen Objekts im Bulk-Verfahren festgelegt.

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

Parameter

NameTypBeschreibung
propertiesObjectein Objekt mit den zu setzenden Eigenschaften.
deleteAllOthersBooleanob alle vorhandenen Properties gelöscht werden sollen.

Rückflug

ScriptProperties – dieses Objekt, zum Verketten

Weitere Informationen


Veraltet. Diese Funktion wurde eingestellt und sollte in neuen Scripts nicht verwendet werden.

Speichert den angegebenen Wert mit dem angegebenen Schlüssel. Alle mit diesem Schlüssel verknüpften Werte werden überschrieben.

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

Parameter

NameTypBeschreibung
keyStringSchlüssel für Property
valueStringWert, der dem Schlüssel zugeordnet werden soll

Rückflug

ScriptProperties – dieses Objekt, zum Verketten

Weitere Informationen