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 Zusammenarbeit
Damit Sie gemeinsam an einem Projekt arbeiten können, müssen Sie und Ihre Mitbearbeiter alle Bearbeitungszugriff auf die Apps Script-Projektdatei (und ihren Container, falls es sich um ein gebundenes Script handelt) haben. 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 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, 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, kann dieses Problem nicht auftreten, da Dateien in einer geteilten Ablage keinen 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 im Leitfaden clasp-Befehlszeilenschnittstelle verwenden.
In geteilten 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. Die Dateien in einer geteilten Ablage gehören der Gruppe als Ganzes und nicht einzelnen Personen. Wenn also ein Mitbearbeiter die Gruppe verlässt, übernimmt er weder die Dateieigentümerschaft 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. 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 Zusammenarbeit 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 Scripteditoren können sie Scriptprojekte ansehen 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 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 sowie 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 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. Dies kann korrigiert werden, indem Sie das Skript zurück in seine ursprüngliche Domain verschieben.
Mithilfe eines freigegebenen Ordners zusammenarbeiten
Wenn die Zusammenarbeit in einer geteilten 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 Nutzer denselben Zugriff auf das Apps Script-Projekt wie auf 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.
- Nutzer mit Lesezugriff auf den Ordner können 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 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 Zugriffseinstellungen für Betrachter und Bearbeiter ihrer Containerdatei.
Alle containergebundenen Skripts verwenden dieselbe Zugriffsliste für Inhaber, Betrachter und Bearbeiter, die für die Containerdatei definiert ist. Der Containerinhaber ist Eigentümer eines neuen Skriptprojekts, 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 Scriptprojekt 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 Auslöser
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 für alle Mitbearbeiter eine einheitliche Triggereinrichtung benötigen, können Sie den Skriptdienst verwenden, um Trigger zur Laufzeit programmatisch zu 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.