Class UserProperties

Proprietàutente

Deprecato. Questa classe è obsoleta e non deve essere utilizzata nei nuovi script.

Le proprietà utente sono coppie chiave/valore uniche per un utente. Le proprietà utente sono limitate per utente; qualsiasi script in esecuzione con l'identità di un utente può accedere solo alle proprietà utente di quell'utente.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
deleteAllProperties()	UserProperties	Elimina tutte le proprietà.
deleteProperty(key)	UserProperties	Elimina la proprietà con la chiave specificata.
getKeys()	String[]	Ottieni tutte le chiavi disponibili.
getProperties()	Object	Recuperare tutte le proprietà disponibili contemporaneamente.
getProperty(key)	String|null	Restituisce il valore associato alla chiave fornita o null se non esiste alcun valore.
setProperties(properties)	UserProperties	Imposta in blocco tutte le proprietà estratte dall'oggetto specificato.
setProperties(properties, deleteAllOthers)	UserProperties	Imposta in blocco tutte le proprietà estratte dall'oggetto specificato.
setProperty(key, value)	UserProperties	Persiste il valore specificato con la chiave fornita.

Metodi ritirati

deleteAllProperties()

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Elimina tutte le proprietà.

UserProperties.deleteAllProperties();

Indietro

UserProperties: questo oggetto, per il concatenamento

Vedi anche

• deleteProperty(key)

---

deleteProperty(key)

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Elimina la proprietà con la chiave specificata.

UserProperties.deleteProperty('special');

Parametri

Nome	Tipo	Descrizione
key	String	chiave della proprietà da eliminare

Indietro

UserProperties: questo oggetto, per il concatenamento

Vedi anche

• deleteAllProperties()

---

getKeys()

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Ottieni tutte le chiavi disponibili.

Indietro

String[]

---

getProperties()

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Recuperare tutte le proprietà disponibili contemporaneamente.

In questo modo viene restituita una copia, non una visualizzazione live, pertanto la modifica delle proprietà dell'oggetto restituito non le aggiornerà nello spazio di archiviazione e viceversa.

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

Indietro

Object: una copia delle proprietà contenenti coppie chiave-valore

---

getProperty(key)

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Restituisce il valore associato alla chiave fornita o null se non esiste alcun valore.

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

Parametri

Nome	Tipo	Descrizione
key	String	chiave per il valore da recuperare

Indietro

String|null: il valore associato alla chiave

Vedi anche

• setProperty(key, value)

---

setProperties(properties)

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Imposta in blocco tutte le proprietà estratte dall'oggetto specificato.

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

Parametri

Nome	Tipo	Descrizione
properties	Object	un oggetto contenente le proprietà da impostare.

Indietro

UserProperties: questo oggetto, per il concatenamento

Vedi anche

• setProperty(key, value)

---

setProperties(properties, deleteAllOthers)

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Imposta in blocco tutte le proprietà estratte dall'oggetto specificato.

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

Parametri

Nome	Tipo	Descrizione
properties	Object	un oggetto contenente le proprietà da impostare.
deleteAllOthers	Boolean	se eliminare tutte le proprietà esistenti.

Indietro

UserProperties: questo oggetto, per il concatenamento

Vedi anche

• setProperty(key, value)

---

setProperty(key, value)

Deprecato. Questa funzione è obsoleta e non deve essere utilizzata nei nuovi script.

Persiste il valore specificato con la chiave fornita. Qualsiasi valore esistente associato a questa chiave verrà sovrascritto.

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

Parametri

Nome	Tipo	Descrizione
key	String	chiave per la proprietà
value	String	valore da associare alla chiave

Indietro

UserProperties: questo oggetto, per il concatenamento

Vedi anche

• getProperty(key)