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 Skript-ID in den Projekteinstellungen.
Seite.Bibliothek dem Skriptprojekt hinzufügen
- Klicken Sie links im Apps Script-Editor neben „Libraries“ (Bibliotheken) auf „Add a“ (Hinzufügen) Bibliothek .
- Im Feld „Skript-ID“ fügen Sie die Skript-ID der Bibliothek ein.
- Klicken Sie auf Suchen.
- Klicken Sie auf das Drop-down-Menü Version und wählen Sie die Version der Bibliothek aus. zu verwenden.
- Ü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()
. - 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 Skripteditor neben dem Namen der Bibliothek auf das Dreipunkt-Menü
> Entfernen > Mediathek entfernen.Mediathek aktualisieren
Sie können die Version der Bibliothek ändern oder ihre ID aktualisieren.
- Klicken Sie links im Editor unter „Libraries“ (Bibliotheken) auf den Namen der Bibliothek.
- Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Speichern.
Fotogalerie erstellen und teilen
Führen Sie die folgenden Schritte aus, um Ihr Skriptprojekt als Bibliothek zu verwenden und freizugeben.
- Versionierte Bereitstellung erstellen des Skripts.
- Teilen Sie allen potenziellen Nutzern der Bibliothek mindestens den Zugriff auf Datenansichtsebene.
- Geben Sie diesen Nutzern die Skript-ID, die Sie im Projekt Einstellungen .
Best Practices
Hier sind einige Richtlinien, die Sie beim Schreiben einer Bibliothek beachten sollten:
- Wählen Sie einen aussagekräftigen Namen für Ihr Projekt, da er als Standardkennung, wenn Ihre Bibliothek von anderen Nutzern verwendet wird.
- 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_()
. - Nur aufzählbare globale Attribute sind für Bibliotheksnutzer sichtbar. Dies beinhaltet die Funktion
Deklarationen, Variablen, die außerhalb einer Funktion mit
var
erstellt wurden, und explizit festgelegte Attribute für das globale Objekt. Beispiel:Object.defineProperty()
, wobeienumerable
auffalse
festgelegt ist erstellt ein Symbol, das Sie in Ihrer Bibliothek verwenden können. Dieses Symbol ist für Ihre Nutzer jedoch nicht zugänglich. 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. Die Das folgende Diagramm zeigt eine gemeinsam genutzte Ressource am Beispiel Nutzereigenschaften:
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 Ihrer 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:
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. in der Bibliothek. | ||
Skripteigenschaften | Dieselbe Instanz ist für alle sichtbar, auch für Skripts, wenn sie in erstellt werden. in der Bibliothek. | ||
Cache | Dieselbe Instanz ist für alle sichtbar, auch für Skripts, wenn sie in erstellt werden. in der Bibliothek. | ||
Trigger | Einfache Trigger, die in der Bibliothek erstellt wurden, werden nicht durch die Einbeziehung . | ||
ScriptApp | |||
UiApp |
|
||
Nutzereigenschaften | |||
Protokollierung und Ausführungstranskript | |||
Google Sites, Google Tabellen und andere Container | Ein Aufruf von getActive() gibt den Container der
einschließlich Skript. |
||
MailApp und GmailApp | |||
* Dies bedeutet, dass die Bibliothek keine eigene Instanz des
Feature/Ressource und verwendet stattdessen die vom Skript erstellte
die sie aufgerufen haben.
** 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
Testen Sie Ihre Bibliothek mit der Head-Bereitstellung. 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.