Class PropertiesService

PropertiesService

Ermöglicht es Scripts, einfache Daten in Schlüssel/Wert-Paaren zu speichern, die auf ein Script, einen Nutzer eines Scripts oder ein Dokument beschränkt sind, in dem ein Add-on verwendet wird. Eigenschaften können nicht zwischen Scripts geteilt werden. Weitere Informationen dazu, wann Sie welchen Property-Typ verwenden 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 ein Property-Store (nur für dieses Script) ab, auf das alle Nutzer im geöffneten Dokument, in der geöffneten Tabelle oder im geöffneten Formular zugreifen können.
getScriptProperties()PropertiesRuft ein Property-Store ab, auf das alle Nutzer zugreifen können, aber nur innerhalb dieses Scripts.
getUserProperties()PropertiesRuft ein Property-Store ab, auf das nur der aktuelle Nutzer und nur innerhalb dieses Scripts zugreifen kann.

Detaillierte Dokumentation

getDocumentProperties()

Ruft ein Property-Store (nur für dieses Script) ab, auf das 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 veröffentlicht und als Add-on ausgeführt wird oder wenn es mit einem Google-Dateityp gebunden ist. Wenn keine Dokumenteneigenschaften verfügbar sind, gibt diese Methode null zurück. Auf Dokumenteigenschaften, die von einem Script erstellt wurden, kann nicht außerhalb dieses Scripts zugegriffen werden, auch nicht von anderen Scripts, die auf dasselbe Dokument zugreifen.

Rückflug

Properties: Ein Property-Store nur für dieses Script, auf den alle Nutzer des aktuellen Dokuments zugreifen können, oder null, wenn das Script kein Add-on ist oder nicht an eine Google Workspace-Datei gebunden ist


getScriptProperties()

Ruft ein Property-Store ab, auf das alle Nutzer zugreifen können, aber nur innerhalb dieses Scripts.

Rückflug

Properties – ein Property-Store, auf den alle Nutzer des Scripts zugreifen können


getUserProperties()

Ruft ein Property-Store ab, auf das nur der aktuelle Nutzer und nur innerhalb dieses Scripts zugreifen kann.

Rückflug

Properties: Property-Store, auf den nur der aktuelle Nutzer des Scripts zugreifen kann