Wenn Sie diese Leitfäden für das Design von Add-ons befolgen, können Sie die Nutzerfreundlichkeit insgesamt verbessern.
Allgemeine Best Practices
Wir empfehlen Ihnen, für alle von Ihnen entwickelten Add-ons die folgenden Best Practices zu befolgen.
Eigentumsrechte für Add-ons vor Beginn bestimmen
Add-ons werden durch Apps Script-Projekte definiert. Diese müssen einem bestimmten Konto gehören oder sich in einer geteilten Ablage befinden. Bestimmen Sie vor dem Codieren eines Add-ons, welchem Konto das Projekt gehören soll und welches Konto als Publisher fungiert. Legen Sie außerdem fest, welche Konten als Mitbearbeiter dienen sollen. Sorgen Sie außerdem dafür, dass diese Konten Zugriff auf das Skriptprojekt und das zugehörige Cloud Platform-Projekt haben.
Google Workspace erweitern, nicht replizieren
Add-ons sollen den von ihnen erweiterten Google Workspace-Anwendungen neue Funktionen zur Verfügung stellen oder auch komplexe Aufgaben automatisieren. Add-ons, die lediglich Funktionen replizieren, die bereits in der Anwendung vorhanden sind, oder solche, die keine wesentlichen Verbesserungen an einem Workflow ermöglichen, werden wahrscheinlich nicht zur Veröffentlichung Add-on-Prüfungen bestehen.
Bereiche begrenzen
Wenn Sie Bereiche explizit definieren, wählen Sie immer die Gruppe von Bereichen mit den geringsten Berechtigungen aus. Beispielsweise haben Sie für Ihre Add-on-Anfrage keinen uneingeschränkten Zugriff auf den Kalender des Nutzers mit dem Bereich https://www.googleapis.com/auth/calendar, wenn sie nur Lesezugriff benötigt. Verwenden Sie für den Lesezugriff den Bereich https://www.googleapis.com/auth/calendar.readonly.
Zu viele Bibliotheken nutzen
Wenn Sie Apps Script-Bibliotheken verwenden, wird Ihr Add-on möglicherweise langsamer ausgeführt als der gesamte Apps Script-Code in einem einzigen Skriptprojekt. Obwohl Apps Script-Bibliotheken in Add-ons funktionieren, kann es zu Leistungseinbußen kommen, wenn Sie sie verwenden. Vermeiden Sie unnötige Bibliotheken in Ihr Projekt und überlegen Sie, wie Sie die Abhängigkeit Ihres Add-ons reduzieren können.
Die oben beschriebene Latenz gilt nur für Apps Script-Projekte, die als serverseitige Bibliotheken verwendet werden. Sie können clientseitige JavaScript-Bibliotheken wie jQuery frei verwenden, ohne dass diese Latenz auftritt.
Best Practices für Editor-Add-ons
Die folgenden Best Practices gelten nur für das Editor-Add-on}.
UI-HTML und clientseitiges JavaScript in eigene Skriptdateien einfügen
Sie können in einem Apps Script-Projekt mehrere Skriptdateien erstellen. Es ist einfacher, ein komplexes Add-on zu verwalten, wenn Sie den HTML- und JavaScript-Code, der die Add-on-Seitenleisten und -Dialogfelder definiert, in dafür vorgesehene Skriptdateien platzieren.
In verschiedenen Autorisierungsmodi vollständig testen
Achten Sie beim Testen Ihres Add-ons darauf, Konfigurationen mit unterschiedlichen Dateien und unterschiedlichen Autorisierungsstatus auszuprobieren.