Immobiliendienst

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 Zeichenfolgen 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:

service/propertyService.gs

Auf GitHub ansehen

try {
  // Set a property in each of the three property stores.
  const scriptProperties = PropertiesService.getScriptProperties();
  const userProperties = PropertiesService.getUserProperties();
  const documentProperties = PropertiesService.getDocumentProperties();

  scriptProperties.setProperty('SERVER_URL', 'http://www.example.com/');
  userProperties.setProperty('DISPLAY_UNITS', 'metric');
  documentProperties.setProperty('SOURCE_DATA_ID',
      '1j3GgabZvXUF177W0Zs_2v--H6SPCQb4pmZ6HsTZYT5k');
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

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:

service/propertyService.gs

Auf GitHub ansehen

try {
  // Set multiple script properties in one call.
  const scriptProperties = PropertiesService.getScriptProperties();
  scriptProperties.setProperties({
    'cow': 'moo',
    'sheep': 'baa',
    'chicken': 'cluck'
  });
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Daten lesen

Um einen einzelnen Wert abzurufen, den Sie zuvor gespeichert haben, rufen Sie Properties.getProperty(key):

service/propertyService.gs

Auf GitHub ansehen

try {
  // Get the value for the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  const units = userProperties.getProperty('DISPLAY_UNITS');
  console.log('values of units %s', units);
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Um alle Werte im aktuellen Property-Speicher abzurufen, rufen Sie folgenden Befehl auf: Properties.getProperties():

service/propertyService.gs

Auf GitHub ansehen

try {
  // Get multiple script properties in one call, then log them all.
  const scriptProperties = PropertiesService.getScriptProperties();
  const data = scriptProperties.getProperties();
  for (const key in data) {
    console.log('Key: %s, Value: %s', key, data[key]);
  }
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Daten ändern

Mit den Methoden getProperty() und getProperties() wird eine Kopie der gespeicherten und keinen Livestream. Wenn Sie das zurückgegebene Objekt ändern, wird der Wert also nicht aktualisiert. im Immobiliengeschäft an. Um die Daten im Speicher zu aktualisieren, speichern Sie sie einfach noch einmal:

service/propertyService.gs

Auf GitHub ansehen

try {
  // Change the unit type in the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  let units = userProperties.getProperty('DISPLAY_UNITS');
  units = 'imperial'; // Only changes local value, not stored value.
  userProperties.setProperty('DISPLAY_UNITS', units); // Updates stored value.
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Daten löschen

Um einen einzelnen Wert zu löschen, rufen Sie Properties.deleteProperty(key):

service/propertyService.gs

Auf GitHub ansehen

try {
  // Delete the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  userProperties.deleteProperty('DISPLAY_UNITS');
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

Um alle Eigenschaften im aktuellen Speicher zu löschen, rufen Sie Properties.deleteAllProperties():

service/propertyService.gs

Auf GitHub ansehen

try {
  // Get user properties in the current script.
  const userProperties = PropertiesService.getUserProperties();
  // Delete all user properties in the current script.
  userProperties.deleteAllProperties();
} catch (err) {
  // TODO (developer) - Handle exception
  console.log('Failed with error %s', err.message);
}

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 müssen sie programmatisch mithilfe der oben in folgendem Artikel beschriebenen Methoden hinzufügen: Daten speichern: Wenn Sie Skripteigenschaften auf der Seite „Projekteinstellungen“ festlegen, ist Folgendes nicht möglich: Variablen des Referenzskripts.

Skripteigenschaften hinzufügen

1. Öffnen Sie Ihr Apps Script-Projekt.
2. Klicken Sie links auf Projekteinstellungen .
3. Um die erste Property hinzuzufügen, klicken Sie unter Skripteigenschaften auf Skripteigenschaft hinzufügen.
4. Wenn Sie eine zweite und nachfolgende Eigenschaften hinzufügen möchten, klicken Sie unter Skripteigenschaften auf Skripteigenschaften bearbeiten > Skripteigenschaft hinzufügen.
5. Geben Sie unter Property den Schlüsselnamen ein.
6. Geben Sie unter Wert den Wert für den Schlüssel ein.
7. Optional: Klicken Sie auf Skripteigenschaft hinzufügen, um weitere Eigenschaften hinzuzufügen.
8. Klicken Sie auf Skripteigenschaften speichern.

Skripteigenschaften bearbeiten

1. Öffnen Sie Ihr Apps Script-Projekt.
2. Klicken Sie links auf Projekteinstellungen .
3. Klicken Sie unter Skripteigenschaften auf Skripteigenschaften bearbeiten.
4. Nehmen Sie für jede Eigenschaft, die Sie ändern möchten, Änderungen am Schlüsselnamen und am Schlüsselwert vor.
5. Klicken Sie auf Skripteigenschaften speichern.

Skripteigenschaften löschen

1. Öffnen Sie Ihr Apps Script-Projekt.
2. Klicken Sie links auf Projekteinstellungen .
3. Klicken Sie unter Skripteigenschaften auf Skripteigenschaften bearbeiten.
4. Klicken Sie neben der Property, die Sie löschen möchten, auf „Entfernen“ .
5. Klicken Sie auf Skripteigenschaften speichern.