Consente agli script di archiviare dati semplici in coppie chiave-valore con un ambito di un singolo script, un utente di un script o un documento in cui viene utilizzato un componente aggiuntivo. Le proprietà non possono essere condivise tra script. Per ulteriori informazioni 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 dell'archivio aperto un documento, un foglio di lavoro o un modulo. |
getScriptProperties() | Properties | Ottiene un archivio proprietà a cui tutti gli utenti possono accedere, ma solo all'interno di questo script. |
getUserProperties() | Properties | Ottiene un archivio proprietà a cui solo l'utente corrente può accedere 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 dell'archivio aperto
un documento, un foglio di lavoro o un modulo. È disponibile solo se lo script è pubblicato ed è in esecuzione
come componente aggiuntivo o vincolato a un file Google
di testo. Quando le proprietà del documento non sono disponibili, questo metodo restituisce null. Documento
proprietà create da uno script non sono accessibili all'esterno di questo, nemmeno da altri script
che accedono allo stesso documento.
Invio
Properties: un archivio proprietà per questo script solo che tutti gli utenti del documento corrente possono
o null se lo script non è un componente aggiuntivo o è associato a
File di Workspace
getScriptProperties()
Ottiene un archivio proprietà a cui tutti gli utenti possono accedere, ma solo all'interno di questo script.
Invio
Properties: un archivio proprietà a cui possono accedere tutti gli utenti dello script
getUserProperties()
Ottiene un archivio proprietà a cui solo l'utente corrente può accedere e solo all'interno di questo script.
Invio
Properties: un archivio proprietà a cui può accedere solo l'utente corrente dello script