Bibliotheken

Eine Bibliothek ist ein Skriptprojekt, dessen Funktionen in anderen Skripts wiederverwendet werden können.

Zugriff auf eine Mediathek erhalten

Wenn Sie Ihrem Projekt eine Bibliothek hinzufügen möchten, müssen Sie mindestens die Ansichtsebene haben darauf zugreifen können. Wenn Sie nicht der Autor der Bibliothek sind, die Sie lesen möchten Kontakt mit dem Autor aufnehmen und Zugriff anfordern.

Sie benötigen die Skript-ID der Bibliothek, die Sie einbinden möchten. Wenn Sie Zugriff auf die Bibliothek haben, finden Sie die Script-ID auf der Seite Projekteinstellungen .

Bibliothek dem Skriptprojekt hinzufügen

  1. Klicken Sie links im Apps Script-Editor neben „Libraries“ (Bibliotheken) auf „Add a“ (Hinzufügen) Bibliothek .
  2. Im Feld „Skript-ID“ fügen Sie die Skript-ID der Bibliothek ein.
  3. Klicken Sie auf Suchen.
  4. Klicken Sie auf das Drop-down-Menü Version und wählen Sie die Version der Bibliothek aus. zu verwenden.
  5. Überprüfen Sie, ob die Standard-ID Name ist der Name, den Sie Bibliothek verwenden können. Dies ist der Name, mit dem Ihr Skript auf die Bibliothek verweisen. Wenn Sie ihn beispielsweise auf Test festlegen, können Sie rufen Sie eine Methode dieser Bibliothek auf: Test.libraryMethod().
  6. Klicken Sie auf Hinzufügen.

Bibliothek verwenden

Verwenden Sie die enthaltene Bibliothek wie einen Standarddienst. Für Wenn beispielsweise Test die ID für Ihre Bibliothek ist, geben Sie Test gefolgt von einem Punkt, um die Liste der Methoden in der Bibliothek aufzurufen.

Die Referenzdokumentation für eine enthaltene Bibliothek kann folgendermaßen geöffnet werden: diese Schritte:

Klicken Sie links im Skripteditor neben dem Namen der Bibliothek auf das Dreipunkt-Menü > In neuem Tab öffnen.

Bibliothek entfernen

Klicken Sie links im Script-Editor neben dem Namen der Bibliothek auf das Dreipunkt-Menü  > Entfernen > Bibliothek entfernen.

Mediathek aktualisieren

Sie können die Version der Bibliothek ändern oder ihre ID aktualisieren.

  1. Klicken Sie links im Editor unter „Libraries“ (Bibliotheken) auf den Namen der Bibliothek.
  2. Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Speichern.

Fotogalerie erstellen und teilen

So verwenden und geben Sie Ihr Script-Projekt als Bibliothek frei:

  1. Versionierte Bereitstellung erstellen des Skripts.
  2. Teilen Sie allen potenziellen Nutzern der Bibliothek mindestens den Zugriff auf Datenansichtsebene.
  3. Gib diesen Nutzern die Script-ID, die du auf der Seite Projekteinstellungen  findest.

Best Practices

Hier sind einige Richtlinien, die Sie beim Schreiben einer Bibliothek beachten sollten:

  1. Wählen Sie einen aussagekräftigen Namen für Ihr Projekt, da er als Standardkennung, wenn Ihre Bibliothek von anderen Nutzern verwendet wird.
  2. Wenn eine oder mehrere Methoden Ihres Skripts nicht sichtbar sein sollen (noch verwendbar) haben, können Sie am Ende des Namens der Methode ein Unterstrich setzen. Beispiel: myPrivateMethod_().
  3. Nur aufzählbare globale Attribute sind für Bibliotheksnutzer sichtbar. Dazu gehören Funktionsdeklarationen, Variablen, die außerhalb einer Funktion mit var erstellt wurden, und Eigenschaften, die explizit auf dem globalen Objekt festgelegt wurden. Beispiel: Object.defineProperty(), wobei enumerable auf false festgelegt ist erstellt ein Symbol, das Sie in Ihrer Bibliothek verwenden können. Dieses Symbol ist für Ihre Nutzer jedoch nicht zugänglich.
  4. Wenn die Nutzer Ihrer Bibliothek die automatische Vervollständigung des Script-Editors automatisch generierte Dokumentation, müssen Sie das JSDoc-Format verwenden, Dokumentation für alle Funktionen. Beispiel:

    /**
     * Raises a number to the given power, and returns the result.
     *
     * @param {number} base the number we're raising to a power
     * @param {number} exp the exponent we're raising the base to
     * @return {number} the result of the exponential calculation
     */
    function power(base, exp) { ... }
    

Ressourcenumfang festlegen

Bei der Arbeit mit Bibliotheken gibt es zwei Arten von Ressourcen: freigegebene Ressourcen und nicht freigegeben. Eine gemeinsam genutzte Ressource bedeutet, dass sowohl die Bibliothek als auch die Integrierten Zugriff auf dieselbe Instanz der Ressource haben. Das folgende Diagramm zeigt eine freigegebene Ressource am Beispiel von Nutzereigenschaften:

Freigegebene Ressource

Eine nicht gemeinsam genutzte Ressource bedeutet, dass sowohl die Bibliothek als auch das einschließlich des Skripts Zugriff nur auf die Instanz der Ressource gewähren. Eine Bibliothek kann jedoch Zugriff auf nicht gemeinsam genutzte Ressourcen gewähren, indem sie explizite Funktionen haben, damit sie von ihnen bearbeitet werden können. Hier ist ein Beispiel für eine Funktion, die Sie in eine der Bibliothek, um die zugehörigen Skripteigenschaften bereitzustellen:

  function getLibraryProperty(key) {
    return ScriptProperties.getProperty(key);
  }

Das folgende Diagramm zeigt eine nicht freigegebene Ressource am Beispiel Skripteigenschaften:

Nicht freigegebene Ressource

In der folgenden Tabelle sind die freigegebenen und nicht freigegebenen Ressourcen aufgeführt:

Ressource Freigegeben* Nicht geteilt** Hinweise
Sperren Dieselbe Instanz ist für alle sichtbar, auch für Skripts, wenn sie in erstellt werden. der Bibliothek.
Skripteigenschaften Die Instanz ist für alle sichtbar, einschließlich Scripts, wenn sie in der Bibliothek erstellt wird.
Cache Die Instanz ist für alle sichtbar, einschließlich Scripts, wenn sie in der Bibliothek erstellt wird.
Trigger Einfache Trigger, die in der Bibliothek erstellt wurden, werden nicht durch die Einbeziehung .
ScriptApp
UiApp
Nutzereigenschaften
Protokoller und Ausführungsprotokoll
Google Sites, Google Tabellen und andere Container Ein Aufruf von getActive() gibt den Container der einschließlich Skript.
MailApp und GmailApp
* Das bedeutet, dass die Bibliothek keine eigene Instanz der Funktion/Ressource hat, sondern stattdessen diejenige verwendet, die vom Skript erstellt wurde, das sie aufgerufen hat.
** Dies bedeutet, dass die Bibliothek eine eigene Instanz der Ressource/Funktion hat. und dass alle Skripts, die die Bibliothek verwenden, auf derselben Instanz.

Bibliothek testen

Verwenden Sie die Head-Bereitstellung, um Ihre Bibliothek zu testen. Alle Nutzer mit Bearbeitungsberechtigung kann der Zugriff auf das Skript die Head-Bereitstellung verwenden.

Bibliotheksfehler beheben

Wenn Sie den Debugger in einem Projekt verwenden, das eine Bibliothek enthält, in eine Funktion der enthaltenen Bibliothek eintreten kann. Der Code erscheint in Debugger im Lesemodus und in der richtigen Version aufrufen.