Class UserProperties

UserProperties

Veraltet. Diese Klasse ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Nutzerattribute sind Schlüssel/Wert-Paare, die für einen Nutzer eindeutig sind. Nutzerattribute sind auf Nutzerebene festgelegt. Alle Skripts, die mit der Identität eines Nutzers ausgeführt werden, können nur auf die Nutzerattribute dieses Nutzers zugreifen.

Veraltete Methoden

Methode	Rückgabetyp	Kurzbeschreibung
deleteAllProperties()	UserProperties	Löscht alle Attribute.
deleteProperty(key)	UserProperties	Löscht das Attribut mit dem angegebenen Schlüssel.
getKeys()	String[]	Ruft alle verfügbaren Schlüssel ab.
getProperties()	Object	Ruft alle verfügbaren Attribute auf einmal ab.
getProperty(key)	String|null	Gibt den Wert zurück, der mit dem angegebenen Schlüssel verknüpft ist. Wenn kein solcher Wert vorhanden ist, wird null zurückgegeben.
setProperties(properties)	UserProperties	Legt alle Attribute aus dem angegebenen Objekt im Bulk-Verfahren fest.
setProperties(properties, deleteAllOthers)	UserProperties	Legt alle Attribute aus dem angegebenen Objekt im Bulk-Verfahren fest.
setProperty(key, value)	UserProperties	Speichert den angegebenen Wert mit dem angegebenen Schlüssel.

Veraltete Methoden

deleteAllProperties()

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Löscht alle Attribute.

UserProperties.deleteAllProperties();

Rückgabe

UserProperties – dieses Objekt zur Verkettung

Weitere Informationen

• deleteProperty(key)

---

deleteProperty(key)

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Löscht das Attribut mit dem angegebenen Schlüssel.

UserProperties.deleteProperty('special');

Parameter

Name	Typ	Beschreibung
key	String	Schlüssel des zu löschenden Attributs

Rückgabe

UserProperties – dieses Objekt zur Verkettung

Weitere Informationen

• deleteAllProperties()

---

getKeys()

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Ruft alle verfügbaren Schlüssel ab.

Rückgabe

String[]

---

getProperties()

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Ruft alle verfügbaren Attribute auf einmal ab.

Hier wird eine Kopie und keine Liveansicht bereitgestellt. Wenn Sie die Attribute im zurückgegebenen Objekt ändern, werden sie nicht im Speicher aktualisiert und umgekehrt.

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

Rückgabe

Object – eine Kopie der Attribute mit Schlüssel/Wert-Paaren

---

getProperty(key)

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

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

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

Parameter

Name	Typ	Beschreibung
key	String	Schlüssel des abzurufenden Werts

Rückgabe

String|null – der mit dem Schlüssel verknüpfte Wert

Weitere Informationen

• setProperty(key, value)

---

setProperties(properties)

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Legt alle Attribute aus dem angegebenen Objekt im Bulk-Verfahren fest.

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

Parameter

Name	Typ	Beschreibung
properties	Object	Ein Objekt mit den festzulegenden Attributen.

Rückgabe

UserProperties – dieses Objekt zur Verkettung

Weitere Informationen

• setProperty(key, value)

---

setProperties(properties, deleteAllOthers)

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Legt alle Attribute aus dem angegebenen Objekt im Bulk-Verfahren fest.

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

Parameter

Name	Typ	Beschreibung
properties	Object	Ein Objekt mit den festzulegenden Attributen.
deleteAllOthers	Boolean	Gibt an, ob alle vorhandenen Attribute gelöscht werden sollen.

Rückgabe

UserProperties – dieses Objekt zur Verkettung

Weitere Informationen

• setProperty(key, value)

---

setProperty(key, value)

Veraltet. Diese Funktion ist veraltet und sollte nicht in neuen Skripts verwendet werden.

Speichert den angegebenen Wert mit dem angegebenen Schlüssel. Alle vorhandenen Werte, die mit diesem Schlüssel verknüpft sind, werden überschrieben.

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

Parameter

Name	Typ	Beschreibung
key	String	Schlüssel des Attributs
value	String	Wert, der mit dem Schlüssel verknüpft werden soll

Rückgabe

UserProperties – dieses Objekt zur Verkettung

Weitere Informationen

• getProperty(key)