Ermöglicht Skripts das Speichern einfacher Daten in Schlüssel/Wert-Paaren für ein Skript, einen Nutzer eines Skripts oder ein Dokument, in dem ein Add-on verwendet wird. Properties können nicht von mehreren Skripts gemeinsam verwendet werden. Weitere Informationen zur Verwendung der einzelnen Property-Typen finden Sie im Leitfaden zum Properties-Dienst.
// 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');
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
getDocumentProperties() | Properties | Ruft einen Eigenschaftenspeicher (nur für dieses Skript) ab, auf den alle Nutzer innerhalb des geöffneten Dokuments, der Tabelle oder des Formulars zugreifen können. |
getScriptProperties() | Properties | Ruft einen Property-Speicher ab, auf den alle Nutzer zugreifen können, jedoch nur innerhalb dieses Skripts. |
getUserProperties() | Properties | Ruft einen Eigenschaftenspeicher ab, auf den nur der aktuelle Nutzer und nur innerhalb dieses Skripts zugreifen kann. |
Detaillierte Dokumentation
getDocumentProperties()
Ruft einen Eigenschaftenspeicher (nur für dieses Skript) ab, auf den alle Nutzer innerhalb des geöffneten Dokuments, der Tabelle oder des Formulars zugreifen können. Sie ist nur verfügbar, wenn das Skript veröffentlicht und als Add-on ausgeführt wird oder wenn es an einen Google-Dateityp gebunden ist. Wenn keine Dokumenteigenschaften verfügbar sind, gibt diese Methode null zurück. Von einem Skript erstellte Dokumenteigenschaften sind außerhalb dieses Skripts nicht zugänglich, auch nicht von anderen Skripts, die auf dasselbe Dokument zugreifen.
Return
Properties: ein Eigenschaftenspeicher für dieses Skript, auf den alle Nutzer des aktuellen Dokuments zugreifen können, oder null, wenn das Skript kein Add-on oder an eine Google Workspace-Datei gebunden ist
getScriptProperties()
Ruft einen Property-Speicher ab, auf den alle Nutzer zugreifen können, jedoch nur innerhalb dieses Skripts.
Return
Properties: Ein Property-Speicher, auf den alle Nutzer des Skripts zugreifen können
getUserProperties()
Ruft einen Eigenschaftenspeicher ab, auf den nur der aktuelle Nutzer und nur innerhalb dieses Skripts zugreifen kann.
Return
Properties: Ein Property-Speicher, auf den nur der aktuelle Nutzer des Skripts zugreifen kann