Class ScriptProperties

ProprietàScript

Ritiro. Questa classe è deprecata e non deve essere utilizzata nei nuovi script.

Le proprietà script sono coppie chiave-valore memorizzate da uno script in un archivio permanente. Le proprietà dello script hanno come ambito ogni script, indipendentemente dall'utente che lo esegue.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
deleteAllProperties()	ScriptProperties	Consente di eliminare tutte le proprietà.
deleteProperty(key)	ScriptProperties	Consente di eliminare la proprietà con la chiave specificata.
getKeys()	String[]	Ottieni tutte le chiavi disponibili.
getProperties()	Object	Visualizza tutte le proprietà disponibili contemporaneamente.
getProperty(key)	String	Restituisce il valore associato alla chiave fornita o null se non esiste un valore di questo tipo.
setProperties(properties)	ScriptProperties	Imposta collettivamente tutte le proprietà ricavate dall'oggetto specificato.
setProperties(properties, deleteAllOthers)	ScriptProperties	Imposta collettivamente tutte le proprietà ricavate dall'oggetto specificato.
setProperty(key, value)	ScriptProperties	Mantiene il valore in specificato con la chiave fornita.

Metodi ritirati

deleteAllProperties()

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Consente di eliminare tutte le proprietà.

ScriptProperties.deleteAllProperties();

Invio

ScriptProperties: questo oggetto, per l'accodamento

Vedi anche

• deleteProperty(key)

---

deleteProperty(key)

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Consente di eliminare la proprietà con la chiave specificata.

ScriptProperties.deleteProperty('special');

Parametri

Nome	Tipo	Descrizione
key	String	Chiave della proprietà da eliminare

Invio

ScriptProperties: questo oggetto, per l'accodamento

Vedi anche

• deleteAllProperties()

---

getKeys()

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Ottieni tutte le chiavi disponibili.

Invio

String[]

---

getProperties()

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Visualizza tutte le proprietà disponibili contemporaneamente.

Viene generata una copia, non una visualizzazione in tempo reale, pertanto la modifica delle proprietà dell'oggetto restituito non le aggiornerà nello spazio di archiviazione e viceversa.

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

Invio

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

---

getProperty(key)

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisce il valore associato alla chiave fornita o null se non esiste un valore di questo tipo.

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

Parametri

Nome	Tipo	Descrizione
key	String	Chiave per il valore da recuperare

Invio

String: il valore associato alla chiave

Vedi anche

• setProperty(key, value)

---

setProperties(properties)

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta collettivamente tutte le proprietà ricavate dall'oggetto specificato.

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

Parametri

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

Invio

ScriptProperties: questo oggetto, per l'accodamento

Vedi anche

• setProperty(key, value)

---

setProperties(properties, deleteAllOthers)

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta collettivamente tutte le proprietà ricavate dall'oggetto specificato.

// This deletes all other properties
ScriptProperties.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.

Invio

ScriptProperties: questo oggetto, per l'accodamento

Vedi anche

• setProperty(key, value)

---

setProperty(key, value)

Ritiro. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

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

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

Parametri

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

Invio

ScriptProperties: questo oggetto, per l'accodamento

Vedi anche

• getProperty(key)