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
Wenn Sie an einem Projekt zusammenarbeiten möchten, benötigen Sie und Ihre Mitbearbeiter Bearbeiterzugriff auf die Apps Script-Projektdatei (und ihren Container, falls es sich um ein gebundenes Skript handelt). So kann jedes Mitglied Ihres Teams den Apps Script-Code sehen und Änderungen daran vornehmen. Bearbeiter können außerdem 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 Ihr Team unterstützen, indem Sie im Voraus planen, wie Sie die Bearbeitung, Überprüfung, Versionierung und gegebenenfalls die Bereitstellung und Veröffentlichung Ihres Projekts, Add-ons oder Ihrer Webanwendung durchführen. Eigenständige Projekte bieten in der Regel die einfachste Zusammenarbeit, 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 jemand anderen im Team zu übertragen. Dies kann dazu führen, dass Sie das Projekt nicht pflegen oder aktualisieren können. Wenn Sie Ihr Skriptprojekt in einer geteilten Ablage ablegen, können Sie dieses Problem vermeiden, 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. Auf diese Weise können Sie die Codeentwicklung optimieren und automatisieren, wenn Sie und Ihre Mitbearbeiter Software zur Versionsverwaltung wie git verwenden.
Weitere Informationen finden Sie im Leitfaden zur Befehlszeile mit clasp.
Über geteilte Ablagen zusammenarbeiten
Geteilte Ablagen (früher „Teamablagen“) bieten einen gemeinsamen Bereich in Google Drive, in dem Gruppen von Drive-Nutzern effektiver zusammenarbeiten können. Dateien in einer geteilten Ablage gehören der gesamten Gruppe, nicht einzelnen Personen. Wenn also ein Mitbearbeiter die Gruppe verlässt, übernimmt er weder die Eigentümerschaft noch 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. Dies kann für Apps Script-Entwickler sehr wertvoll sein, da ein Team damit Add-ons, Webanwendungen oder anderen Code für Kunden in verschiedenen Domains entwickeln kann.
Wenn Sie geteilte Ablagen für die Zusammenarbeit an Apps Script-Projekten verwenden, sollten Sie Folgendes beachten:
- Mitbearbeiter mit Bearbeitungszugriff auf eine geteilte Ablage können neue Dateien erstellen oder in die geteilte Ablage verschieben. Als Skriptbearbeiter können sie Skriptprojekte ansehen und bearbeiten, Skriptcode ausführen, neue Skriptversionen erstellen und Add-ons veröffentlichen.
- Wenn Sie Skripts 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 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 Personen außerhalb der Gruppe freigeben und ihre Bearbeitungs- und Leseberechtigungen für diese Dateien wie jede andere Drive-Datei aktualisieren. Wenn ein Nutzer jedoch zu dem Team gehört, zu dem die geteilte Ablage gehört, können Sie den Zugriff auf bestimmte Dateien nicht einschränken. Wenn ein Nutzer beispielsweise Bearbeitungszugriff auf eine geteilte Ablage hat, können Sie dies nicht zu „Lesezugriff“ für eine bestimmte Datei innerhalb der geteilten Ablage ändern.
- Mitbearbeiter mit uneingeschränktem Zugriff auf eine geteilte Ablage können außerdem Dateien und Apps Script-Projekte löschen sowie Dateien aus der geteilten Ablage verschieben.
- Alle containergebundenen Skripts verwenden dieselben Zugriffslisten für Betrachter und Editoren, die für die Containerdatei definiert sind. Wenn Sie beispielsweise Bearbeitungszugriff auf eine Google-Tabelle haben, haben Sie auch Bearbeitungszugriff auf alle angehängten Apps Script-Projektcodes. Wenn Sie eine solche Containerdatei in einer geteilten Ablage platzieren, 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, ist der Zugriff auf das zugehörige Cloud Platform-Projekt (GCP) möglicherweise eingeschränkt. Weitere Informationen finden Sie im Leitfaden zu GCP-Projekten und geteilten Ablagen.
- In einer Domain bereitgestellte Web-Apps funktionieren nicht mehr, wenn sich die Eigentümerschaft einer geteilten Ablage oder eines Kontos in einer anderen Domain ändert. Verschieben Sie das Skript zurück in seine ursprüngliche Domain, um das Problem zu beheben.
- Ebenso funktionieren Scriptprojekte, die als ausführbare Apps Script API bereitgestellt werden, wenn sie von der API aufgerufen werden, wenn sie über eine geteilte Ablage von einer Domain in eine andere verschoben werden. Sie können das Problem beheben, indem Sie das Skript zurück in seine ursprüngliche Domain verschieben.
Mit einem freigegebenen Ordner zusammenarbeiten
Wenn Sie nicht über eine geteilte Ablage zusammenarbeiten können, können Sie stattdessen einen freigegebenen Ordner verwenden. Wenn Sie ein Apps Script-Projekt in einen Google Drive-Ordner erstellen oder in einen Google Drive-Ordner verschieben, auf den andere Personen zugreifen können, erhalten alle Nutzer denselben Zugriff auf das Apps Script-Projekt wie auf den Ordner. Beispiel:
- Wenn ein Nutzer Bearbeitungszugriff auf den Ordner hat, kann er das Apps Script-Projekt bearbeiten oder löschen und das Skript ausführen.
- Wenn ein Nutzer nur Lesezugriff auf den Ordner hat, kann er das Apps Script-Projekt ansehen und das Skript ausführen.
Über die Projektfreigabe zusammenarbeiten
Sie können ein Projekt gemeinsam bearbeiten, indem Sie es direkt für alle Mitbearbeiter freigeben. Skriptprojekte, die sich in regulären Google Drive-Ordnern oder in geteilten Ablagen befinden, lassen sich direkt freigeben. Wenn Sie diese Methode verwenden, sollten Sie sorgfältig planen, wer Inhaber 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 an eine Tabelle in Google Tabellen gebunden haben, können Sie jemanden zum Bearbeiter des Skripts machen, indem Sie ihn zu einem Bearbeiter der Tabelle machen. Containergebundene Projekte übernehmen die Einstellungen für den Betrachter- und Bearbeiterzugriff der Containerdatei.
Alle containergebundenen Skripts verwenden dieselbe Inhaber-, Betrachter- und Bearbeitungszugriffsliste, die für die Containerdatei definiert ist. Der Containerinhaber übernimmt die Eigentümerschaft eines neuen Skriptprojekts unabhängig davon, wer es erstellt hat.
Zusammenarbeit 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 die Ressourcen auswirkt, insbesondere auf das Cloud Platform-Projekt, die Trigger, die Bibliotheken und die 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 von Nutzern 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 Ihnen, die Google Cloud-Inhaber und -Rollen zu konfigurieren, damit alle Ihre Mitbearbeiter die entsprechenden Zugriffsberechtigungen haben. So wird verhindert, dass Sie den Zugriff auf die Cloud-Einstellungen des Projekts verlieren, weil die Inhaber nicht mehr Ihrer Organisation angehören. Das ist für Add-ons besonders wichtig.
Zusammenarbeit und Auslöser
Wenn Sie an einem Projekt mitarbeiten, werden von Ihnen erstellte installierbare Trigger nicht für Personen freigegeben, die Zugriff auf das Projekt haben. Wenn Sie eine konsistente Triggereinrichtung für alle Mitbearbeiter benötigen, können Sie den Skriptdienst verwenden, um Trigger programmatisch zur Laufzeit zu erstellen. Weitere Informationen finden Sie unter Trigger programmatisch verwalten.
Zusammenarbeit und Bibliotheken
Die in Ihrem Projekt enthaltenen Bibliotheken stehen Projektbeteiligten zur Verfügung. Wenn sie jedoch nicht mindestens Lesezugriff auf eine enthaltene Bibliothek haben, können sie diese Bibliotheken nicht verwenden. In diesem Fall gibt das Skript einen Fehler aus. Weitere Informationen zu Bibliotheken finden Sie unter Bibliotheken verwalten.
Zusammenarbeit und Nutzereigenschaften
Nutzereigenschaften gelten nur für den Nutzer, der sie erstellt hat. Das bedeutet, dass die Projektbearbeiter weder Ihre Nutzereigenschaften sehen noch darauf zugreifen können. Auch Sie können deren Nutzereigenschaften weder sehen noch aufrufen. Wenn Sie projektspezifische Attribute für die Mitbearbeiter freigeben möchten, verwenden Sie Skripteigenschaften. Weitere Informationen finden Sie im Eigenschaftenleitfaden.