Permite que las secuencias de comandos almacenen datos simples en pares clave-valor con alcance a una secuencia de comandos, un usuario de una secuencia de comandos o un documento en el que se usa un complemento. Las propiedades no se pueden compartir entre secuencias de comandos. Para obtener más información sobre cuándo usar cada tipo de propiedad, consulte la guía del servicio de propiedades.
// 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');
Métodos
| Método | Tipo de datos que se muestra | Descripción breve |
|---|---|---|
getDocumentProperties() | Properties | Obtiene un almacén de propiedades (solo para esta secuencia de comandos) al que todos los usuarios pueden acceder dentro del documento, la hoja de cálculo o el formulario abiertos. |
getScriptProperties() | Properties | Obtiene una tienda de propiedades a la que pueden acceder todos los usuarios, pero solo dentro de esta secuencia de comandos. |
getUserProperties() | Properties | Obtiene un almacén de propiedades al que solo puede acceder el usuario actual y dentro de esta secuencia de comandos. |
Documentación detallada
getDocumentProperties()
Obtiene un almacén de propiedades (solo para esta secuencia de comandos) al que todos los usuarios pueden acceder dentro del documento, la hoja de cálculo o el formulario abiertos. Solo está disponible si la secuencia de comandos se publica y se ejecuta como un complemento o si está vinculada a un tipo de archivo de Google. Cuando las propiedades del documento no están disponibles, este método muestra null. No se puede acceder a las propiedades del documento creadas por una secuencia de comandos fuera de esa secuencia de comandos, incluso si otras secuencias de comandos acceden al mismo documento.
Volver
Properties: Es un almacén de propiedades de esta secuencia de comandos solo al que pueden acceder todos los usuarios del documento actual o null si la secuencia de comandos no es un complemento ni está vinculada a un archivo de Google Workspace.
getScriptProperties()
Obtiene una tienda de propiedades a la que pueden acceder todos los usuarios, pero solo dentro de esta secuencia de comandos.
Volver
Properties: Es un almacén de propiedades al que pueden acceder todos los usuarios de la secuencia de comandos.
getUserProperties()
Obtiene un almacén de propiedades al que solo puede acceder el usuario actual y dentro de esta secuencia de comandos.
Volver
Properties: Es un almacén de propiedades al que solo puede acceder el usuario actual de la secuencia de comandos.