Il servizio delle proprietà consente di archiviare dati semplici in coppie chiave-valore limitate come ambito a uno script, a un utente di uno script o a un documento in cui viene utilizzato un componente aggiuntivo. In genere viene utilizzato per archiviare la configurazione dello sviluppatore o le preferenze utente. Le proprietà non vengono mai condivise tra gli script.
Per visualizzare le quote giornaliere e i limiti di archiviazione per il servizio Properties, consulta Quote per i servizi Google.
Confronto tra negozi di proprietà
L'oggetto globale PropertiesService
offre tre metodi, ognuno dei quali restituisce un oggetto Properties
simile ma con diritti di accesso diversi, come mostrato nella tabella seguente:
Proprietà script | Proprietà utente | Proprietà documento | |
---|---|---|---|
Metodo di accesso | getScriptProperties() |
getUserProperties() |
getDocumentProperties() |
Dati condivisi tra | Tutti gli utenti di uno script, un componente aggiuntivo o un'app web | L'utente corrente di uno script, un componente aggiuntivo o un'app web | Tutti gli utenti di un componente aggiuntivo nel documento aperto |
Utilizzato di solito per | Dati di configurazione a livello di app, ad esempio il nome utente e la password per il database esterno dello sviluppatore | Impostazioni specifiche per l'utente, ad esempio il sistema metrico o il sistema imperiale | Dati specifici dei documenti, ad esempio l'URL di origine di un grafico incorporato |
Formato dei dati
Il servizio Proprietà archivia tutti i dati come stringhe in coppie chiave-valore. I tipi di dati che non sono già stringhe vengono convertiti automaticamente in stringhe, inclusi i metodi contenuti negli oggetti salvati.
Salvataggio dati
Per salvare un singolo valore, chiama il metodo Properties.setProperty(key,
value)
dell'archivio appropriato, come mostrato nell'esempio seguente:
Per salvare i dati collettivamente, trasmetti una mappa di coppie chiave-valore a Properties.setProperties(properties)
.
Ogni coppia chiave-valore dell'oggetto nel parametro viene archiviata come una proprietà separata:
Lettura dei dati
Per recuperare un singolo valore salvato in precedenza, chiama Properties.getProperty(key)
:
Per recuperare tutti i valori nell'archivio proprietà corrente, chiama
Properties.getProperties()
:
Modifica dei dati
I metodi getProperty()
e getProperties()
restituiscono una copia dei dati archiviati, non una visualizzazione in tempo reale, quindi la modifica dell'oggetto restituito non aggiornerà il valore nell'archivio proprietà. Per aggiornare i dati nello store, è sufficiente salvarlo di nuovo:
Eliminazione di dati
Per eliminare un singolo valore, chiama
Properties.deleteProperty(key)
:
Per eliminare tutte le proprietà nel negozio corrente, chiama
Properties.deleteAllProperties()
:
Gestire manualmente le proprietà degli script
Puoi aggiungere manualmente fino a 50 proprietà personalizzate, come stringhe nelle coppie chiave-valore, dalla pagina delle impostazioni progetto. Per aggiungere più di 50 proprietà, devi aggiungerle in modo programmatico utilizzando i metodi descritti sopra nella sezione Salvataggio dei dati. Quando imposti le proprietà dello script dalla pagina delle impostazioni del progetto, non puoi fare riferimento alle variabili degli script.
Aggiungi proprietà script
- Apri il progetto Apps Script.
- A sinistra, fai clic su Impostazioni progetto .
- Per aggiungere la prima proprietà, in Proprietà script fai clic su Aggiungi proprietà script.
- Per aggiungere una seconda proprietà e quelle successive, in Proprietà script fai clic su Modifica proprietà script > Aggiungi proprietà script.
- In Proprietà, inserisci il nome della chiave.
- In Valore, inserisci il valore della chiave.
- (Facoltativo) Per aggiungere altre proprietà, fai clic su Aggiungi proprietà script.
- Fai clic su Salva proprietà script.
Modifica proprietà script
- Apri il progetto Apps Script.
- A sinistra, fai clic su Impostazioni progetto .
- In Proprietà script, fai clic su Modifica proprietà script.
- Apporta le modifiche al nome e al valore della chiave per ogni proprietà da modificare.
- Fai clic su Salva proprietà script.
Elimina proprietà script
- Apri il progetto Apps Script.
- A sinistra, fai clic su Impostazioni progetto .
- In Proprietà script, fai clic su Modifica proprietà script.
- Accanto alla proprietà da eliminare, fai clic su Rimuovi .
- Fai clic su Salva proprietà script.