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 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 de propiedades.
// Sets three properties of different types. const documentProperties = PropertiesService.getDocumentProperties(); const scriptProperties = PropertiesService.getScriptProperties(); const 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 |
---|---|---|
get | 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. |
get | Properties | Obtiene un almacén de propiedades al que todos los usuarios pueden acceder, pero solo dentro de esta secuencia de comandos. |
get | 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
get Document 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. Solo está disponible si la secuencia de comandos se publica y ejecuta como 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 que crea una secuencia de comandos fuera de ella, ni siquiera a través de otras secuencias de comandos que accedan al mismo documento.
Volver
Properties
: Es un almacén de propiedades solo para esta secuencia de comandos 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.
get Script Properties()
Obtiene un almacén de propiedades al que todos los usuarios pueden acceder, 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.
get User Properties()
Obtiene un almacén de propiedades al que solo puede acceder el usuario actual y solo 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.