Позволяет сценариям хранить простые данные в парах «ключ-значение», ограниченных одним сценарием, одним пользователем сценария или одним документом, в котором используется надстройка. Свойства не могут быть общими для разных сценариев. Дополнительные сведения о том, когда использовать каждый тип свойства, см. в руководстве по службе свойств .
// 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');Методы
| Метод | Тип возврата | Краткое описание |
|---|---|---|
get Document Properties() | Properties | Получает хранилище свойств (только для этого сценария), к которому все пользователи могут получить доступ в открытом документе, электронной таблице или форме. |
get Script Properties() | Properties | Получает хранилище свойств, к которому могут получить доступ все пользователи, но только в рамках этого скрипта. |
get User Properties() | Properties | Получает хранилище свойств, к которому имеет доступ только текущий пользователь и только в рамках этого скрипта. |
Подробная документация
get Document Properties()
Получает хранилище свойств (только для этого сценария), к которому все пользователи могут получить доступ в открытом документе, электронной таблице или форме. Он доступен только в том случае, если сценарий опубликован и выполняется как надстройка или если он привязан к типу файла Google. Если свойства документа недоступны, этот метод возвращает null . Свойства документа, созданные сценарием, недоступны за пределами этого сценария, даже для других сценариев, обращающихся к тому же документу.
Возвращаться
Properties — хранилище свойств только для этого скрипта, доступное всем пользователям текущего документа, или null если скрипт не является надстройкой или не привязан к файлу Google Workspace.
get Script Properties()
Получает хранилище свойств, к которому могут получить доступ все пользователи, но только в рамках этого скрипта.
Возвращаться
Properties — хранилище свойств, к которому имеют доступ все пользователи скрипта.
get User Properties()
Получает хранилище свойств, к которому имеет доступ только текущий пользователь и только в рамках этого скрипта.
Возвращаться
Properties — хранилище свойств, к которому имеет доступ только текущий пользователь скрипта.