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

service/propertyService.gs
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
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
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
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
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
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
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 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

  1. Öffnen Sie Ihr Apps Script-Projekt.
  2. Klicken Sie links auf Projekteinstellungen Das Symbol für die 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 Das Symbol für die 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 Das Symbol für die 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.