Class PropertiesService

СвойстваСервис

Позволяет сценариям хранить простые данные в парах "ключ-значение" для одного сценария, одного пользователя сценария или одного документа, в котором используется надстройка. Свойства не могут использоваться совместно скриптами. Дополнительные сведения о том, когда использовать каждый тип свойств, см. в руководстве по службе свойств .

// 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');

Методы

Метод Тип возврата Краткое описание
getDocumentProperties() Properties Получает хранилище свойств (только для этого скрипта), доступ к которому имеют все пользователи в открытом документе, электронной таблице или форме.
getScriptProperties() Properties Получает хранилище свойств, доступ к которому имеют все пользователи, но только в пределах этого скрипта.
getUserProperties() Properties Получает хранилище свойств, к которому может получить доступ только текущий пользователь и только в пределах этого скрипта.

Подробная документация

getDocumentProperties()

Получает хранилище свойств (только для этого скрипта), доступ к которому имеют все пользователи в открытом документе, электронной таблице или форме. Он доступен только в том случае, если скрипт опубликован и выполняется как надстройка или если он привязан к типу файла Google. Когда свойства документа недоступны, этот метод возвращает null . Свойства документа, созданные сценарием, недоступны вне этого сценария, даже для других сценариев, обращающихся к тому же документу.

Возвращаться

Properties — хранилище свойств только для этого скрипта, к которому могут получить доступ все пользователи текущего документа, или null , если скрипт не является надстройкой или не привязан к файлу Google Workspace.


getScriptProperties()

Получает хранилище свойств, доступ к которому имеют все пользователи, но только в пределах этого скрипта.

Возвращаться

Properties — хранилище свойств, к которому имеют доступ все пользователи скрипта.


getUserProperties()

Получает хранилище свойств, к которому может получить доступ только текущий пользователь и только в пределах этого скрипта.

Возвращаться

Properties — хранилище свойств, доступ к которому может получить только текущий пользователь скрипта.