Consente agli script di archiviare dati semplici in coppie chiave-valore il cui ambito è uno script, un utente di uno script o un documento in cui viene utilizzato un componente aggiuntivo. Le proprietà non possono essere condivise tra gli script. Per saperne di più su quando utilizzare ciascun tipo di proprietà, consulta la guida al servizio Proprietà.
// Sets three properties of different types.
var documentProperties = PropertiesService.getDocumentProperties();
var scriptProperties = PropertiesService.getScriptProperties();
var userProperties = PropertiesService.getUserProperties();
documentProperties.setProperty('DAYS_TO_FETCH', '5');
scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/MyWeatherService/');
userProperties.setProperty('DISPLAY_UNITS', 'metric');
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
getDocumentProperties() | Properties | Recupera un archivio 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() | Properties | Recupera un archivio proprietà a cui tutti gli utenti possono accedere, ma solo all'interno di questo script. |
getUserProperties() | Properties | Recupera un archivio proprietà a cui può accedere solo l'utente corrente e solo all'interno di questo script. |
Documentazione dettagliata
getDocumentProperties()
Recupera un archivio proprietà (solo per questo script) a cui tutti gli utenti possono accedere all'interno del documento, del foglio di lavoro o del modulo aperto. È disponibile solo se lo script è pubblicato ed è in esecuzione come componente aggiuntivo o se è associato a un tipo di file Google. Quando le proprietà del documento non sono disponibili, questo metodo restituisce null. Le proprietà del documento create da uno script non sono accessibili al di fuori di quello script, neanche da altri script che accedono allo stesso documento.
Ritorni
Properties: un archivio proprietà per questo script accessibile solo a tutti gli utenti del documento corrente oppure null se lo script non è un componente aggiuntivo o non è associato a un file di Google Workspace
getScriptProperties()
Recupera un archivio proprietà a cui tutti gli utenti possono accedere, ma solo all'interno di questo script.
Ritorni
Properties: un archivio proprietà a cui possono accedere tutti gli utenti dello script.
getUserProperties()
Recupera un archivio proprietà a cui può accedere solo l'utente corrente e solo all'interno di questo script.
Ritorni
Properties: un archivio proprietà a cui può accedere solo l'utente corrente dello script