Add-ons für den Gebäudeeditor

Bevor Sie Ihr Editor-Add-on erstellen, sollten Sie sich die Apps Script-Kontingente und ‑Einschränkungen ansehen, um sicherzustellen, dass Ihr Projektdesign diesen Richtlinien entspricht. Wenn Sie sich frühzeitig im Entwicklungsprozess mit diesen Einschränkungen vertraut machen, können Sie potenzielle Probleme später vermeiden. Apps Script eignet sich ideal für die Entwicklung von Add-ons für Sie selbst, Ihr Team oder Ihre Organisation. Wenn Sie jedoch ein Add‑on in großem Maßstab entwickeln möchten, das viele Nutzer verarbeiten muss, eine geringe Latenz erfordert oder eine vollständige Kontrolle über Ihre Infrastruktur erfordert, sollten Sie ein Google Workspace-Add‑on in einer anderen Laufzeitumgebung entwickeln.

Gehen Sie beim Erstellen eines Editor-Add-ons so vor:

  1. Erstellen Sie ein Apps Script-Projekt.
  2. Schreiben Sie Code, um das Erscheinungsbild und das Verhalten des Add-ons zu definieren. Verwenden Sie dazu den integrierten Apps Script-HTML-Dienst.
  3. Testen Sie das Add-on.
  4. Veröffentlichen Sie das Add-on.

Skriptprojekt erstellen

Ein Editor-Add‑on ist ein eigenständiges Apps Script-Projekt. Im Leitfaden für eigenständige Skripts finden Sie Anleitungen zum Erstellen neuer Projekte. Sie können auch einfach ein neues Script öffnen. In diesem Fall wird die Projektdatei (anfangs mit dem Namen Untitled project) in Ihrem Google Drive-Stammordner abgelegt.

Zusammenarbeit

Wenn Sie mit anderen an der Entwicklung eines Add-ons zusammenarbeiten, gehört das Add-on-Projekt einem einzelnen Nutzerkonto. Wenn Sie ein Add-on veröffentlichen, fungiert ein einzelnes Nutzerkonto als Publisher. Das Veröffentlichungskonto muss Bearbeitungszugriff auf das Add-on-Scriptprojekt haben, muss aber nicht der Projektinhaber sein.

Es ist sehr wichtig, Situationen zu vermeiden, in denen Sie den Zugriff auf den Code oder die Einstellungen eines Add-ons verlieren, weil der Inhaber des Projekts Ihre Organisation verlassen hat.

Damit Sie nicht den Zugriff auf Add-on-Code verlieren, empfehlen wir Ihnen, gemeinsame Ablagen zu verwenden, wenn Sie an einem Add-on zusammenarbeiten. Wenn Sie die Add-on-Scriptdatei in einer geteilten Ablage platzieren, ist kein einzelnes Konto der alleinige Inhaber des Projekts.

Es wird außerdem empfohlen, Mitbearbeiter zum Cloud Platform-Projekt (GCP) des Skriptprojekts hinzuzufügen. So kann immer ein Mitglied Ihres Teams auf die Cloudeinstellungen des Add-ons zugreifen.

Add-on programmieren

Nachdem Sie ein Scriptprojekt erstellt haben, können Sie mit dem Schreiben von Code beginnen, um das Erscheinungsbild und das Verhalten des Add-ons zu definieren. Sie verwenden den Apps Script-HtmlService, um die Add-on-Benutzeroberfläche – Dialogfelder und Seitenleisten – mit herkömmlichem HTML und CSS zu erstellen. Editor-Add-ons können auch benutzerdefinierte Menüpunkte definieren.

Beachten Sie beim Programmieren die Stilrichtlinien für Editor-Add-ons, um zu erfahren, wie Sie die User Experience Ihres Add-ons gestalten können. Außerdem sollten Sie die verschiedenen Zustände des Autorisierungslebenszyklus, die bei Ihrem Add-on auftreten können, kennen und entsprechend programmieren.

Add-on testen

Sie können Editor-Add-ons testen, bevor sie veröffentlicht werden, um sicherzustellen, dass sie sich wie erwartet verhalten. Für das Testen müssen Sie eine Testkonfiguration erstellen und ein Testdokument, eine Testtabelle, ein Testformular oder eine Testpräsentation verwenden.

Weitere Informationen finden Sie unter Editor-Add-on testen.

Add-on veröffentlichen

Wenn Sie Ihr Add-on veröffentlichen, ist es für andere verfügbar, entweder öffentlich oder nur für Nutzer in Ihrer Domain. Bevor Sie mit der Veröffentlichung beginnen, sollten Sie sich die Übersicht über die Veröffentlichung ansehen.

Editor-Add‑ons werden im Google Workspace Marketplace veröffentlicht. Öffentlich verfügbare Add-ons müssen die Add-on-Überprüfung durchlaufen, bevor sie veröffentlicht werden.

Weitere Informationen finden Sie unter Editor-Add-on veröffentlichen.