Questa pagina è stata tradotta dall'API Cloud Translation.

Class ScriptProperties

Obsoleta. 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à degli script hanno un ambito per script, indipendentemente da quale utente lo esegue.

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
`deleteAllProperties()`	`ScriptProperties`	Elimina tutte le proprietà.
`deleteProperty(key)`	`ScriptProperties`	Elimina la proprietà con la chiave specificata.
`getKeys()`	`String[]`	Recupera tutte le chiavi disponibili.
`getProperties()`	`Object`	Visualizza contemporaneamente tutte le proprietà disponibili.
`getProperty(key)`	`String`	Restituisce il valore associato alla chiave fornita oppure null se tale valore non esiste.
`setProperties(properties)`	`ScriptProperties`	Imposta in blocco tutte le proprietà estratte dall'oggetto specificato.
`setProperties(properties, deleteAllOthers)`	`ScriptProperties`	Imposta in blocco tutte le proprietà estratte dall'oggetto specificato.
`setProperty(key, value)`	`ScriptProperties`	Mantieni il valore specificato con la chiave fornita.

Metodi deprecati

`deleteAllProperties()`

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

Elimina tutte le proprietà.

ScriptProperties.deleteAllProperties();

Ritorni

ScriptProperties: questo oggetto per il concatenamento

Vedi anche

deleteProperty(key)

`deleteProperty(key)`

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

Elimina la proprietà con la chiave specificata.

ScriptProperties.deleteProperty('special');

Parametri

Nome	Tipo	Descrizione
`key`	`String`	chiave per la proprietà da eliminare

Ritorni

ScriptProperties: questo oggetto per il concatenamento

Vedi anche

deleteAllProperties()

`getKeys()`

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

Recupera tutte le chiavi disponibili.

Ritorni

String[]

`getProperties()`

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

Visualizza contemporaneamente tutte le proprietà disponibili.

Questo genera una copia, non una visualizzazione in tempo reale, quindi la modifica delle proprietà dell'oggetto restituito non ne aggiorna lo 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]);
}

Ritorni

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

`getProperty(key)`

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

Restituisce il valore associato alla chiave fornita oppure null se tale valore non esiste.

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

Parametri

Nome	Tipo	Descrizione
`key`	`String`	chiave per il valore da recuperare

Ritorni

String: il valore associato alla chiave

Vedi anche

setProperty(key, value)

`setProperties(properties)`

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

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

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

Parametri

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

Ritorni

ScriptProperties: questo oggetto per il concatenamento

Vedi anche

setProperty(key, value)

`setProperties(properties, deleteAllOthers)`

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

Imposta in blocco tutte le proprietà estratte 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.

Ritorni

ScriptProperties: questo oggetto per il concatenamento

Vedi anche

setProperty(key, value)

`setProperty(key, value)`

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

Mantieni il valore 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

Ritorni

ScriptProperties: questo oggetto per il concatenamento

Vedi anche

getProperty(key)