Apps Script bietet einige Funktionen, mit denen Sie und andere Entwickler Skripts, Add-ons und Webanwendungen gemeinsam erstellen und verwalten können.
Grundlagen der Zusammenarbeit
Um an einem Projekt zusammenarbeiten zu können, benötigen Sie und Ihre Mitbearbeiter Bearbeitungszugriff auf die Apps Script-Projektdatei (und deren Container, falls es sich um ein gebundenes Skript handelt). So können alle Mitglieder Ihres Teams den Apps Script-Code sehen und ändern. Bearbeiter können auch neue Codeversionen erstellen, Add-ons veröffentlichen und Skripts als Webanwendungen oder ausführbare Dateien für die Apps Script API bereitstellen.
Sie können Ihrem Team helfen, indem Sie im Voraus planen, wie Sie die Bearbeitung, Überprüfung, Versionsverwaltung und gegebenenfalls die Bereitstellung und Veröffentlichung Ihres Projekts, Add-ons oder Ihrer Webanwendung durchführen. Eigenständige Projekte sind in der Regel am einfachsten zu bearbeiten, da sie direkt in Google Drive angezeigt werden und der empfohlene Projekttyp für die Entwicklung von Add-ons und Webanwendungen sind.
Ein häufiges Problem bei der Zusammenarbeit tritt auf, wenn ein Skriptprojektinhaber das Team verlässt, ohne die Eigentümerschaft des Projekts an eine andere Person im Team zu übertragen. Dies kann dazu führen, dass Sie das Projekt nicht verwalten oder aktualisieren können. Wenn Sie Ihr Skriptprojekt in eine geteilte Ablage verschieben, können Sie dieses Problem vermeiden, da Dateien in einer geteilten Ablage keine bestimmten Eigentümer haben.
Mit dem clasp-Befehlszeilentool zusammenarbeiten
Mit clasp können Sie Projekte zwischen script.google.com und Ihrem lokalen Dateisystem synchronisieren. So können Sie die Codeentwicklung optimieren und automatisieren, wenn Sie und Ihre Mitbearbeiter Software zur Verwaltung der Versionsverwaltung wie git verwenden.
Weitere Informationen finden Sie in der Anleitung Befehlszeile mit clasp.
Über geteilte Ablagen zusammenarbeiten
Geteilte Ablagen (früher „Geteilte Ablagen“) sind ein freigegebener Bereich in Google Drive, in dem Gruppen von Drive-Nutzern effektiver zusammenarbeiten können. Dateien in einer geteilten Ablage gehören der gesamten Gruppe und nicht einzelnen Personen. Wenn also ein Mitbearbeiter die Gruppe verlässt, übernimmt er weder die Dateiinhaberschaft noch die Kontrolle mit ihm.
Mit geteilten Ablagen können Sie auch Dateien zwischen Domains verschieben. Eine geteilte Ablage in einer Domain kann Mitbearbeiter aus einer anderen Domain haben, die Dateien aus dieser Domain in die geteilte Ablage verschieben können. Dies kann für Apps Script-Entwickler sehr nützlich sein, da es einem Team die Möglichkeit gibt, Add-ons, Webanwendungen oder anderen Code für Kunden in verschiedenen Domains zu entwickeln.
Wenn Sie geteilte Ablagen für die Zusammenarbeit an Apps Script-Projekten verwenden, beachten Sie Folgendes:
- Mitbearbeiter mit Bearbeitungszugriff auf eine geteilte Ablage können neue Dateien erstellen oder in die geteilte Ablage verschieben. Als Scripteditoren können sie Scriptprojekte ansehen und bearbeiten, Scriptcode ausführen, neue Scriptversionen erstellen und Add-ons veröffentlichen.
- Damit Skripts als Webanwendungen oder ausführbare Dateien für die Apps Script API bereitgestellt werden können, muss das Konto, mit dem die Bereitstellung erstellt wird, zur selben Domain gehören wie die geteilte Ablage, in der sich das Skript befindet.
- Mit geteilten Ablagen können Sie bestimmte Dateien innerhalb der geteilten Ablage für andere Personen außerhalb der Gruppe freigeben und deren Bearbeitungs- und Leseberechtigungen für diese Dateien wie bei jeder anderen Drive-Datei ändern. Wenn ein Nutzer jedoch zum Team der geteilten Ablage gehört, können Sie seinen Zugriff auf bestimmte Dateien nicht einschränken. Wenn ein Nutzer beispielsweise Bearbeitungszugriff auf eine geteilte Ablage hat, können Sie für eine bestimmte Datei darin nicht nur Lesezugriff gewähren.
- Mitbearbeiter mit uneingeschränktem Zugriff auf eine geteilte Ablage können auch Dateien und Apps Script-Projekte löschen und Dateien aus der geteilten Ablage verschieben.
- Alle containergebundenen Skripts verwenden dieselben Betrachter- und Bearbeiterzugriffslisten, die für die Containerdatei definiert sind. Wenn Sie beispielsweise Bearbeitungszugriff auf eine Google-Tabelle haben, haben Sie auch Bearbeitungszugriff auf den zugehörigen Apps Script-Projektcode. Wenn Sie eine solche Containerdatei in einer geteilten Ablage ablegen, erhalten die Mitbearbeiter der geteilten Ablage denselben Zugriff auf den Skriptcode wie für den Container selbst.
- Wenn sich ein Skriptprojekt in einer geteilten Ablage befindet, kann der Zugriff auf das zugehörige Cloud Platform-Projekt (GCP) eingeschränkt werden. Weitere Informationen finden Sie im Abschnitt GCP-Projekte und geteilte Ablagen.
- Web-Apps, die in einer Domain bereitgestellt wurden, funktionieren nicht mehr, wenn ihre Eigentümerschaft an eine geteilte Ablage oder ein Konto in einer anderen Domain übertragen wird. Dies kann korrigiert werden, indem Sie das Skript zurück in seine ursprüngliche Domain verschieben.
- In ähnlicher Weise funktionieren Skriptprojekte, die als ausführbare Apps Script API bereitgestellt werden, nicht mehr, wenn sie von der API aufgerufen werden, wenn sie über eine geteilte Ablage von einer Domain in eine andere verschoben werden. Dies kann korrigiert werden, indem Sie das Skript zurück in seine ursprüngliche Domain verschieben.
Mithilfe eines freigegebenen Ordners zusammenarbeiten
Wenn die Zusammenarbeit über eine geteilte Ablage nicht möglich ist, können Sie stattdessen einen freigegebenen Ordner verwenden. Wenn Sie ein Apps Script-Projekt erstellen oder in einen Google Drive-Ordner verschieben, auf den andere Nutzer zugreifen können, erhalten diese denselben Zugriff auf das Apps Script-Projekt wie für den Ordner. Beispiel:
- Wenn jemand Bearbeitungszugriff auf den Ordner hat, kann er das Apps Script-Projekt bearbeiten oder löschen und das Skript ausführen.
- Wenn jemand nur Lesezugriff auf den Ordner hat, kann er das Apps Script-Projekt aufrufen und das Skript ausführen.
Über die Projektfreigabe zusammenarbeiten
Sie können an einem Projekt zusammenarbeiten, indem Sie es direkt für alle Mitbearbeiter freigeben. Sie können Skriptprojekte, die sich in regulären Google Drive-Ordnern oder in geteilten Ablagen befinden, direkt freigeben. Wenn Sie diese Methode verwenden, sollten Sie im Laufe der Zeit sorgfältig planen, wer Eigentümer und Verwalter des Skripts ist.
Eigenständige Projekte werden in Google Drive als Datei angezeigt und können wie jede andere Datei freigegeben werden. Weitere Informationen finden Sie unter Dateien und Ordner freigeben.
Containergebundene Projekte sind in Google Drive nicht sichtbar. Wenn Sie ein containergebundenes Projekt freigeben möchten, geben Sie die übergeordnete Containerdatei frei. Wenn Sie beispielsweise ein Skript mit einer Tabelle in Google Tabellen verknüpft haben, können Sie jemanden zum Bearbeiter des Skripts machen, indem Sie ihn zum Bearbeiter der Tabelle machen. Containergebundene Projekte übernehmen die Einstellungen für den Betrachter- und Bearbeiterzugriff der zugehörigen Containerdatei.
Alle containergebundenen Skripts verwenden dieselbe Zugriffsliste für Inhaber, Betrachter und Bearbeiter, die für die Containerdatei definiert ist. Der Containerinhaber ist Inhaber eines neuen Skriptprojekts, unabhängig davon, wer es erstellt hat.
Zusammenarbeits- und Projektressourcen
Ressourcen sind Entitäten, die mit Ihrem Projekt verknüpft sind, aber unabhängig von seinem Code existieren. In diesem Abschnitt wird erläutert, wie sich die Zusammenarbeit an einem Projekt auf dessen Ressourcen auswirkt, insbesondere auf dessen Cloud Platform-Projekt, Trigger, Bibliotheken und Nutzereigenschaften.
Zusammenarbeit und Google Cloud-Projekte
Jedes Apps Script-Projekt ist mit einem Google Cloud-Projekt verknüpft. Google Cloud-Projekte haben eigene Inhaber, Bearbeiter und andere Rollen, die sich von der Gruppe der Nutzer unterscheiden können, die auf das Skriptprojekt zugreifen können.
Wenn Ihr Skriptprojekt als Add-on veröffentlicht werden soll, muss ein Google Cloud-Standardprojekt verwendet werden. Wenn Sie an einer Anwendung zusammenarbeiten, die ein Google Cloud-Standardprojekt verwendet, empfehlen wir, die Google Cloud-Inhaber und -Rollen so zu konfigurieren, dass alle Ihre Mitbearbeiter die richtigen Zugriffsebenen haben. So lassen sich Situationen vermeiden, in denen Sie den Zugriff auf die Cloud-Einstellungen des Projekts verlieren, weil dessen Inhaber nicht mehr bei Ihrer Organisation sind. Das ist besonders wichtig für Add-ons.
Zusammenarbeit und Auslöser
Wenn Sie an einem Projekt zusammenarbeiten, werden von Ihnen erstellte installierbare Trigger nicht für Personen freigegeben, die Zugriff auf das Projekt haben. Wenn Sie für alle Mitbearbeiter eine einheitliche Triggereinrichtung benötigen, können Sie den Script-Dienst verwenden, um Trigger zur Laufzeit programmatisch zu erstellen. Weitere Informationen finden Sie unter Trigger programmatisch verwalten.
Zusammenarbeit und Bibliotheken
In Ihrem Projekt enthaltene Bibliotheken stehen Projektbeteiligten zur Verfügung. Wenn sie jedoch nicht mindestens Lesezugriff auf eine enthaltene Bibliothek haben, können sie diese Bibliotheken nicht verwenden. Das Skript gibt in diesem Fall einen Fehler aus. Weitere Informationen zu Bibliotheken finden Sie unter Bibliotheken verwalten.
Zusammenarbeit und Nutzereigenschaften
Nutzereigenschaften sind für den Nutzer, der sie erstellt hat, eindeutig. Das bedeutet, dass Projektmitarbeiter weder Ihre Nutzereigenschaften sehen noch darauf zugreifen können und Sie ihre nicht sehen oder darauf zugreifen können. Verwenden Sie Skripteigenschaften, wenn Sie projektspezifische Attribute für die Mitbearbeiter freigeben möchten. Weitere Informationen finden Sie im Leitfaden zu Properties.