Consente 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. 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 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() | Properties | Recupera un archivio di proprietà a cui tutti gli utenti possono accedere, ma solo all'interno di questo script. |
getUserProperties() | Properties | Recupera un archivio di proprietà a cui solo l'utente corrente può accedere e solo all'interno di questo script. |
Documentazione dettagliata
getDocumentProperties()
Recupera 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. È disponibile solo se lo script è stato pubblicato ed eseguito come componente aggiuntivo o se è vincolato a un tipo di file Google. Se le proprietà del documento non sono disponibili, questo metodo restituisce null. Le proprietà del documento create da uno script non sono accessibili all'esterno di quello script, anche da altri script che accedono allo stesso documento.
Andata e ritorno
Properties: un archivio di proprietà per questo script solo a cui possono accedere tutti gli utenti del documento corrente oppure null se lo script non è un componente aggiuntivo o non è vincolato a un file di Google Workspace
getScriptProperties()
Recupera un archivio di proprietà a cui tutti gli utenti possono accedere, ma solo all'interno di questo script.
Andata e ritorno
Properties: un archivio di proprietà a cui possono accedere tutti gli utenti dello script
getUserProperties()
Recupera un archivio di proprietà a cui solo l'utente corrente può accedere e solo all'interno di questo script.
Andata e ritorno
Properties: un archivio di proprietà a cui può accedere solo l'utente corrente dello script