Apps Script bietet einige Funktionen, mit denen Sie und andere Entwickler gemeinsam Scripts, Add-ons und Web-Apps erstellen und verwalten können.
Grundlagen der Gruppenarbeit
Damit Sie gemeinsam an einem Projekt arbeiten können, benötigen Sie und Ihre Mitbearbeiter Bearbeitungszugriff auf die Apps Script-Projektdatei (und ihren Container, falls es sich um ein gebundenes Script handelt). So können alle Mitglieder Ihres Teams den Apps Script-Code sehen und Änderungen daran vornehmen. Bearbeiter können auch neue Codeversionen erstellen, Add-ons veröffentlichen und Scripts als Webanwendungen oder als 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, Versionierung und (falls zutreffend) die Bereitstellung und Veröffentlichung Ihres Projekts, Add-ons oder Ihrer Webanwendung handhaben. Mit eigenständigen Projekten lässt sich am einfachsten zusammenarbeiten, da sie direkt in Google Drive angezeigt werden. Dieser Projekttyp wird für die Entwicklung von Add-ons und Webanwendungen empfohlen.
Ein häufiges Problem bei der Zusammenarbeit tritt auf, wenn der Inhaber eines Scriptprojekts das Team verlässt, ohne die Inhaberschaft des Projekts auf eine andere Person im Team zu übertragen. Das kann dazu führen, dass Sie das Projekt nicht mehr verwalten oder aktualisieren können. Wenn Sie Ihr Scriptprojekt in einer geteilten Ablage speichern, lässt sich 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 Versionskontrolle wie git verwenden.
Weitere Informationen finden Sie im Leitfaden clasp-Befehlszeilenschnittstelle verwenden.
In geteilten Ablagen zusammenarbeiten
Geteilte Ablagen (früher „Teamablagen“) bieten einen gemeinsamen Speicherplatz in Google Drive, in dem Gruppen von Google Drive-Nutzern noch effektiver zusammenarbeiten können. Die Eigentümer von Dateien in einer geteilten Ablage sind nicht einzelne Personen, sondern die Gruppe als Ganzes. Wenn also ein Mitbearbeiter die Gruppe verlässt, behält er nicht die Eigentumsrechte und die Kontrolle über die Datei.
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. Das kann für Apps Script-Entwickler sehr wertvoll sein, da ein Team so Add-ons, Webanwendungen oder anderen Code für Kunden in verschiedenen Bereichen entwickeln kann.
Wenn Sie geteilte Ablagen für die Gruppenarbeit an Apps Script-Projekten verwenden, beachten Sie Folgendes:
- Mitbearbeiter mit Bearbeitungszugriff auf eine geteilte Ablage können neue Dateien in die geteilte Ablage erstellen oder verschieben. Als Script-Bearbeiter können sie Scriptprojekte aufrufen und bearbeiten, Scriptcode ausführen, neue Scriptversionen erstellen und Add-ons veröffentlichen.
- Wenn Sie Scripts als Webanwendungen oder ausführbare Dateien für die Apps Script API bereitstellen möchten, muss das Konto, mit dem die Bereitstellung erstellt wird, zur selben Domain wie das freigegebene Laufwerk gehören, auf dem sich das Script befindet.
- Mit geteilten Ablagen können Sie bestimmte Dateien in der geteilten Ablage für andere Nutzer außerhalb der Gruppe freigeben und die Bearbeitungs- und Leseberechtigungen für diese Dateien wie bei jeder anderen Drive-Datei aktualisieren. Wenn ein Nutzer jedoch zum Team gehört, dem die geteilte Ablage gehört, können Sie seinen Zugriff für bestimmte Dateien nicht einschränken. Wenn ein Nutzer beispielsweise Bearbeitungszugriff auf eine geteilte Ablage hat, können Sie dies nicht für eine bestimmte Datei in der geteilten Ablage in Lesezugriff ändern.
- Mitbearbeiter mit uneingeschränktem Zugriff auf eine geteilte Ablage können außerdem Dateien und Apps Script-Projekte löschen und Dateien aus der geteilten Ablage verschieben.
- Für alle containergebundenen Scripts werden dieselben Zugriffslisten für Betrachter und Bearbeiter verwendet, 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 eine geteilte Ablage verschieben, erhalten die Mitbearbeiter der geteilten Ablage denselben Zugriff auf den Scriptcode wie auf den Container selbst.
- Wenn sich ein Script-Projekt in einer freigegebenen Google Drive-Ablage befindet, ist der Zugriff auf das zugehörige Google Cloud-Projekt (GCP-Projekt) möglicherweise eingeschränkt. Weitere Informationen finden Sie im Abschnitt GCP-Projekte und freigegebene Ablagen.
- Web-Apps, die in einer Domain bereitgestellt werden, funktionieren nicht mehr, wenn die Inhaberschaft auf ein freigegebenes Laufwerk oder Konto in einer anderen Domain übertragen wird. Das kann korrigiert werden, indem das Script wieder in die ursprüngliche Domain verschoben wird.
- Ebenso funktionieren Scriptprojekte, die als ausführbare Datei der Apps Script API bereitgestellt werden, nicht mehr, wenn sie über ein freigegebenes Laufwerk von einer Domain in eine andere verschoben werden. Das kann korrigiert werden, indem das Script wieder in die ursprüngliche Domain verschoben wird.
Mit einem freigegebenen Ordner zusammenarbeiten
Wenn Sie keine Gruppenarbeit mit einer geteilten Ablage durchführen können, 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 Nutzer denselben Zugriff auf das Apps Script-Projekt wie auf den Ordner. Beispiel:
- Nutzer mit Bearbeitungszugriff auf den Ordner können das Apps Script-Projekt bearbeiten oder löschen und das Script ausführen.
- Wenn ein Nutzer nur Lesezugriff auf den Ordner hat, kann er das Apps Script-Projekt aufrufen und das Script ausführen.
Mit der Projektfreigabe zusammenarbeiten
Sie können an einem Projekt zusammenarbeiten, indem Sie es direkt für alle Mitbearbeiter freigeben. Sie können Scriptprojekte, die sich in regulären Google Drive-Ordnern oder in geteilten Ablagen befinden, direkt freigeben. Wenn Sie diese Methode verwenden, sollten Sie sorgfältig planen, wer der Inhaber des Scripts ist und es im Laufe der Zeit verwaltet.
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.
Containerbasierte 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 Script mit einer Google-Tabelle verknüpft haben, können Sie jemanden zum Bearbeiter des Scripts machen, indem Sie ihn zum Bearbeiter der Tabelle machen. Containergebundene Projekte übernehmen die Zugriffseinstellungen für Betrachter und Bearbeiter ihrer Containerdatei.
Alle containergebundenen Scripts verwenden dieselbe Zugriffsliste für Inhaber, Betrachter und Bearbeiter, die für die Containerdatei definiert ist. Der Containerinhaber übernimmt die Inhaberschaft für ein neues Scriptprojekt, unabhängig davon, wer es erstellt hat.
Ressourcen für die Zusammenarbeit und für Projekte
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 die zugehörigen Ressourcen auswirkt, insbesondere auf das Cloud-Plattform-Projekt, Trigger, Bibliotheken und Nutzereigenschaften.
Gruppenarbeit und Google Cloud-Projekte
Jedem Apps Script-Projekt ist ein Google Cloud-Projekt zugeordnet. Google Cloud-Projekte haben eigene Inhaber, Bearbeiter und andere Rollen, die sich von den Nutzern unterscheiden können, die auf das Scriptprojekt zugreifen können.
Wenn Ihr Script-Projekt als Add-on veröffentlicht werden soll, muss es ein Google Cloud-Standardprojekt verwenden. Wenn Sie an einer Anwendung zusammenarbeiten, für die ein standardmäßiges Google Cloud-Projekt verwendet wird, sollten Sie die Google Cloud-Inhaber und -Rollen konfigurieren, damit alle Mitbearbeiter die richtigen Zugriffsrechte haben. So lässt sich vermeiden, dass Sie den Zugriff auf die Cloud-Einstellungen des Projekts verlieren, weil die Inhaber nicht mehr in Ihrer Organisation sind. Das ist besonders wichtig für Add-ons.
Zusammenarbeit und Trigger
Wenn Sie an einem Projekt zusammenarbeiten, werden von Ihnen erstellte installierbare Trigger nicht für Nutzer freigegeben, die Zugriff auf Ihr Projekt haben. Wenn Sie eine einheitliche Triggereinrichtung für alle Mitbearbeiter benötigen, können Sie mit dem Script-Dienst Trigger programmgesteuert zur Laufzeit erstellen. Weitere Informationen finden Sie unter Trigger programmatisch verwalten.
Gruppenarbeit und Bibliotheken
In Ihrem Projekt enthaltene Bibliotheken sind für Projektmitbearbeiter verfügbar. Wenn der Nutzer jedoch keinen Lesezugriff auf eine enthaltene Bibliothek hat, kann er diese Bibliotheken nicht verwenden. In diesem Fall löst das Script 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 die Projektmitbearbeiter Ihre Nutzereigenschaften nicht sehen oder darauf zugreifen können und Sie ihre nicht sehen oder darauf zugreifen können. Verwenden Sie Script-Properties, wenn Sie projektspezifische Properties für die Mitbearbeiter freigeben möchten. Weitere Informationen finden Sie im Leitfaden zu Properties.