Permite que las secuencias de comandos almacenen datos simples en pares clave-valor limitados a una secuencia de comandos, un usuario de una secuencia de comandos o un documento en el que se use un complemento. No se pueden compartir propiedades entre secuencias de comandos. Para obtener más información sobre cuándo utilizar cada tipo de propiedad, consulta la guía del servicio Properties.
// 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 puedan acceder dentro del documento, la hoja de cálculo o el formulario abiertos. |
getScriptProperties() | Properties | Obtiene un almacén de propiedades al que todos los usuarios pueden acceder, 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 solo 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 puedan 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, incluso mediante otras secuencias de comandos que acceden al mismo documento.
Devolvedor
Properties
: Es un almacén de propiedades para esta secuencia de comandos solo al que pueden acceder todos los usuarios del documento actual, o bien null
si la secuencia de comandos no es un complemento ni está vinculada a un archivo de Google Workspace.
getScriptProperties()
Obtiene un almacén de propiedades al que todos los usuarios pueden acceder, pero solo dentro de esta secuencia de comandos.
Devolvedor
Properties
: 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 solo dentro de esta secuencia de comandos.
Devolvedor
Properties
: Un almacén de propiedades al que solo puede acceder el usuario actual de la secuencia de comandos