Properties Service

Proprietà

Questo servizio consente agli script di archiviare stringhe come coppie chiave-valore con ambito a uno script, a un utente di uno script o a un documento in cui viene utilizzato un componente aggiuntivo dell'editor. Per saperne di più su quando utilizzare ogni tipo di proprietà, consulta la guida al servizio Properties.

Corsi

NomeBreve descrizione
PropertiesL'oggetto delle proprietà funge da interfaccia per accedere alle proprietà dell'utente, del documento o dello script.
PropertiesServiceConsente agli script di archiviare dati semplici in coppie chiave-valore con ambito a uno script, a un utente di uno script o a un documento in cui viene utilizzato un componente aggiuntivo.
ScriptPropertiesLe proprietà dello script sono coppie chiave-valore archiviate da uno script in un archivio permanente.
UserPropertiesLe proprietà utente sono coppie chiave-valore univoche per un utente.

Properties

Metodi

MetodoTipo restituitoBreve descrizione
deleteAllProperties()PropertiesElimina tutte le proprietà nell'archivio Properties corrente.
deleteProperty(key)PropertiesElimina la proprietà con la chiave specificata nell'archivio Properties corrente.
getKeys()String[]Recupera tutte le chiavi nell'archivio Properties corrente.
getProperties()ObjectRecupera una copia di tutte le coppie chiave-valore nell'archivio Properties corrente.
getProperty(key)StringRecupera il valore associato alla chiave specificata nell'archivio Properties corrente o null se non esiste una chiave di questo tipo.
setProperties(properties)PropertiesImposta tutte le coppie chiave-valore dell'oggetto specificato nell'archivio Properties corrente.
setProperties(properties, deleteAllOthers)PropertiesImposta tutte le coppie chiave-valore dell'oggetto specificato nell'archivio Properties corrente, eliminando facoltativamente tutte le altre proprietà nell'archivio.
setProperty(key, value)PropertiesImposta la coppia chiave-valore specificata nell'archivio Properties corrente.

PropertiesService

Metodi

MetodoTipo restituitoBreve descrizione
getDocumentProperties()PropertiesRecupera un archivio di proprietà (solo per questo script) a cui tutti gli utenti possono accedere all'interno del documento, del foglio di lavoro o del modulo aperto.
getScriptProperties()PropertiesRecupera un archivio di proprietà a cui tutti gli utenti possono accedere, ma solo all'interno di questo script.
getUserProperties()PropertiesRecupera un archivio di proprietà a cui solo l'utente corrente o effettivo può accedere e solo all'interno di questo script.

ScriptProperties

UserProperties