Permite que las secuencias de comandos almacenen datos simples en pares clave-valor con alcance para una secuencia de comandos, un usuario de una 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, consulta la guía del servicio 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 entorno abierto documento, hoja de cálculo o formulario. |
getScriptProperties() | Properties | Obtiene un almacén de propiedades al 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 únicamente 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 entorno abierto
documento, hoja de cálculo o formulario. Solo está disponible si se publica la secuencia de comandos y se ejecuta
Como complemento o si está vinculado a un archivo de Google
el tipo de letra. Cuando las propiedades del documento no están disponibles, este método muestra null
. Documento
No se puede acceder a las propiedades creadas por una secuencia de comandos fuera de esa secuencia, ni siquiera otras secuencias de comandos
accediendo al mismo documento.
Volver
Properties
: Es un almacén de propiedades para esta secuencia de comandos que solo pueden usar todos los usuarios del documento actual.
o null
si la secuencia de comandos no es un complemento ni está vinculada a una
Archivo del espacio de trabajo
getScriptProperties()
Obtiene un almacén de propiedades al 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 únicamente 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.