Class PropertiesService

Служба недвижимости

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

// 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 Получает хранилище свойств, доступное всем пользователям, но только внутри этого скрипта.
getUserProperties() Properties Получает хранилище свойств, доступ к которому имеет только текущий или фактический пользователь, и только в рамках этого скрипта.

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

get Document Properties()

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

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

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

get Script Properties()

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

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

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

get User Properties()

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

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

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