Class PropertiesService

AttributeService

Ermöglicht es Skripts, einfache Daten in Schlüssel/Wert-Paaren zu speichern, die auf ein Skript, einen Nutzer eines Skripts oder ein Dokument beschränkt sind, in dem ein Add-on verwendet wird. Eigenschaften können nicht zwischen Skripts freigegeben werden. Weitere Informationen dazu, wann die einzelnen Arten von Properties verwendet werden sollten, finden Sie im Leitfaden zum Properties-Dienst. 

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

Methoden

MethodeRückgabetypKurzbeschreibung
getDocumentProperties()PropertiesRuft einen Eigenschaftenspeicher (nur für dieses Skript) ab, auf den alle Nutzer im geöffneten Dokument, in der geöffneten Tabelle oder im geöffneten Formular zugreifen können.
getScriptProperties()PropertiesRuft einen Property Store ab, auf den alle Nutzer zugreifen können, aber nur innerhalb dieses Skripts.
getUserProperties()PropertiesRuft einen Property Store ab, auf den nur der aktuelle oder effektive Nutzer zugreifen kann und nur innerhalb dieses Skripts.

Detaillierte Dokumentation

getDocumentProperties()

Ruft einen Eigenschaftenspeicher (nur für dieses Skript) ab, auf den alle Nutzer im geöffneten Dokument, in der geöffneten Tabelle oder im geöffneten Formular zugreifen können. Sie ist nur verfügbar, wenn das Script als Add-on veröffentlicht und ausgeführt wird oder wenn es an einen Google-Dateityp gebunden ist. Wenn keine Dokumentattribute verfügbar sind, wird mit dieser Methode null zurückgegeben. Auf Dokumenteigenschaften, die von einem Skript erstellt wurden, kann außerhalb dieses Skripts nicht zugegriffen werden, auch nicht von anderen Skripts, die auf dasselbe Dokument zugreifen.

Rückflug

Properties: Ein Speichermedium für Eigenschaften nur für dieses Skript, auf das alle Nutzer des aktuellen Dokuments zugreifen können, oder null, wenn das Skript kein Add‑on ist und nicht an eine Google Workspace-Datei gebunden ist.

getScriptProperties()

Ruft einen Property Store ab, auf den alle Nutzer zugreifen können, aber nur innerhalb dieses Skripts.

Rückflug

Properties: Ein Property-Speicher, auf den alle Nutzer des Skripts zugreifen können.

getUserProperties()

Ruft einen Property Store ab, auf den nur der aktuelle oder effektive Nutzer zugreifen kann und nur innerhalb dieses Skripts.

Rückflug

Properties: Ein Property-Speicher, auf den nur der aktuelle oder effektive Nutzer des Skripts zugreifen kann.