Mit dem Properties-Dienst können Sie einfache Daten in Schlüssel/Wert-Paaren, die einem Skript, einem Nutzer eines Skripts oder ein Dokument, in dem ein Add-on verwendet wird. Es ist werden in der Regel zum Speichern von Entwicklerkonfigurationen oder Nutzereinstellungen verwendet. Eigenschaften werden niemals zwischen Skripts geteilt.
Informationen zu den Tageskontingenten und Speicherlimits für den Properties-Dienst finden Sie unter Kontingente für Google-Dienste.
Vergleich von Immobilienspeichern
Die
PropertiesService
globales Objekt bietet drei Methoden, von denen jede eine ähnliche
Properties
-Objekt aber mit unterschiedlichen Zugriffsrechten, wie in der folgenden Tabelle dargestellt:
Skripteigenschaften | Nutzereigenschaften | Dokumenteigenschaften | |
---|---|---|---|
Zugriffsmethode | getScriptProperties() |
getUserProperties() |
getDocumentProperties() |
Daten, die zwischen | Alle Nutzer eines Skripts, eines Add-ons oder einer Webanwendung | Der aktuelle Nutzer eines Skripts, Add-ons oder einer Webanwendung | Alle Nutzer eines Add-ons im geöffneten Dokument |
Üblicherweise verwendet für | App-weite Konfigurationsdaten wie Nutzername und Passwort für die Externe Datenbank des Entwicklers | Nutzerspezifische Einstellungen, z. B. metrische oder imperiale Einheiten | Dokumentspezifische Daten wie die Quell-URL eines eingebetteten Diagramms |
Datenformat
Der Properties-Dienst speichert alle Daten als Strings in Schlüssel/Wert-Paaren. Datentypen die noch nicht als Zeichenfolgen definiert sind, werden automatisch in Strings konvertiert, einschließlich -Methoden, die in gespeicherten -Objekten enthalten sind.
Daten werden gespeichert
Rufen Sie die Methode Properties.setProperty(key,
value)
auf, um einen einzelnen Wert zu speichern.
des entsprechenden Shops, wie im folgenden Beispiel gezeigt:
Um Daten im Bulk zu speichern, übergeben Sie eine Zuordnung von Schlüssel/Wert-Paaren an
Properties.setProperties(properties)
Jedes Schlüssel/Wert-Paar des Objekts im Parameter wird als
Property:
Daten lesen
Um einen einzelnen Wert abzurufen, den Sie zuvor gespeichert haben, rufen Sie
Properties.getProperty(key)
:
Um alle Werte im aktuellen Property-Speicher abzurufen, rufen Sie folgenden Befehl auf:
Properties.getProperties()
:
Daten ändern
Mit den Methoden getProperty()
und getProperties()
wird eine Kopie der gespeicherten
und keinen Livestream, sodass der Wert nicht aktualisiert wird, wenn Sie das zurückgegebene Objekt ändern.
im Immobiliengeschäft an. Um die Daten im Speicher zu aktualisieren, speichern Sie sie einfach noch einmal:
Daten löschen
Um einen einzelnen Wert zu löschen, rufen Sie
Properties.deleteProperty(key)
:
Um alle Eigenschaften im aktuellen Speicher zu löschen, rufen Sie
Properties.deleteAllProperties()
:
Skripteigenschaften manuell verwalten
Sie können bis zu 50 benutzerdefinierte Eigenschaften manuell als Zeichenfolgen in Schlüssel/Wert-Paaren hinzufügen. auf der Seite mit den Projekteinstellungen. Um mehr als 50 Properties hinzuzufügen, müssen Sie hinzugefügt werden, indem Sie sie mithilfe der oben unter Daten speichern: Wenn Sie Skripteigenschaften auf der Seite „Projekteinstellungen“ festlegen, ist Folgendes nicht möglich: Variablen des Referenzskripts.
Skripteigenschaften hinzufügen
- Öffnen Sie Ihr Apps Script-Projekt.
- Klicken Sie links auf Projekteinstellungen
.
- Um die erste Property hinzuzufügen, klicken Sie unter Skripteigenschaften auf Skripteigenschaft hinzufügen.
- Wenn Sie eine zweite und nachfolgende Eigenschaften hinzufügen möchten, klicken Sie unter Skripteigenschaften auf Skripteigenschaften bearbeiten > Skripteigenschaft hinzufügen.
- Geben Sie unter Property den Schlüsselnamen ein.
- Geben Sie unter Wert den Wert für den Schlüssel ein.
- Optional: Klicken Sie auf Skripteigenschaft hinzufügen, um weitere Eigenschaften hinzuzufügen.
- Klicken Sie auf Skripteigenschaften speichern.
Skripteigenschaften bearbeiten
- Öffnen Sie Ihr Apps Script-Projekt.
- Klicken Sie links auf Projekteinstellungen
.
- Klicken Sie unter Skripteigenschaften auf Skripteigenschaften bearbeiten.
- Nehmen Sie für jede Eigenschaft, die Sie ändern möchten, Änderungen am Schlüsselnamen und am Schlüsselwert vor.
- Klicken Sie auf Skripteigenschaften speichern.
Skripteigenschaften löschen
- Öffnen Sie Ihr Apps Script-Projekt.
- Klicken Sie links auf Projekteinstellungen
.
- Klicken Sie unter Skripteigenschaften auf Skripteigenschaften bearbeiten.
- Klicken Sie neben der Property, die Sie löschen möchten, auf „Entfernen“ .
- Klicken Sie auf Skripteigenschaften speichern.