Wenn Sie Google Workspace-Organisationen zusammenführen, müssen Sie Ihre Chat-App möglicherweise migrieren, damit sie weiterhin funktioniert.
Bevor Sie Ihre Chat-App migrieren, erkundigen Sie sich beim Administrator Ihrer Organisation, ob sich administrative Einstellungen darauf auswirken. Wenn Sie eine Verwaltungseinstellung ändern, kann die Chat-App wieder vollständig funktionieren und eine Migration ist nicht erforderlich. Möglicherweise muss Ihr Google Workspace-Administrator Ihre Chat-App beispielsweise einer Zulassungsliste hinzufügen oder Nutzern erlauben, Chat-Apps zu installieren. Weitere Informationen finden Sie unter Feststellen, ob Google Chat-Apps nach der Zusammenführung von Google Workspace-Organisationen migriert werden müssen.
Wenn Sie festgestellt haben, dass Sie Ihre Chat-App migrieren müssen, führen Sie die folgenden drei Schritte aus:
- Richten Sie die Umgebung für Ihre Chat-App ein, indem Sie in der zusammengeführten Organisation ein Google Cloud-Projekt erstellen, APIs aktivieren und gegebenenfalls den OAuth 2.0-Zustimmungsbildschirm konfigurieren.
- Stellen Sie Ihre Chat-App aus dem neuen Cloud-Projekt neu bereit.
- Fügen Sie die neu erstellte Chat-App zu Chat-Gruppenbereichen oder ‑Unterhaltungen hinzu und deaktivieren Sie die ursprüngliche Chat-App.
Cloud-Projekt in der zusammengeführten Organisation erstellen und APIs aktivieren
Wenn Sie ein neues Cloud-Projekt erstellen und APIs für die Chat-App in der zusammengeführten Google Workspace-Organisation aktivieren, können Nutzer und Gruppen, denen Sie den Zugriff auf die Chat-App erlauben, diese ohne Fehler verwenden.
Cloud-Projekt erstellen
Google Cloud Console
- Klicken Sie in der Google Cloud Console auf das Dreipunkt-Menü > IAM und Verwaltung > Projekt erstellen.
-
Geben Sie im Feld Projektname einen aussagekräftigen Namen für Ihr Projekt ein.
Optional: Klicken Sie auf Bearbeiten, um die Projekt-ID zu bearbeiten. Die Projekt-ID kann nach dem Erstellen des Projekts nicht mehr geändert werden. Wählen Sie also eine ID aus, die während der gesamten Dauer des Projekts den Anforderungen entspricht.
- Klicken Sie im Feld Standort auf Durchsuchen, um mögliche Standorte für Ihr Projekt zu sehen. Klicken Sie danach auf Auswählen.
- Klicken Sie auf Erstellen. In der Google Cloud Console wird die Seite „Dashboard“ geöffnet und Ihr Projekt wird innerhalb weniger Minuten erstellt.
gcloud-CLI
Rufen Sie in einer der folgenden Entwicklungsumgebungen die Google Cloud CLI (gcloud) auf:
-
Cloud Shell: Aktivieren Sie Cloud Shell, um ein Onlineterminal mit der bereits eingerichteten gcloud CLI zu verwenden.
Cloud Shell aktivieren -
Lokale Shell: Zur Verwendung einer lokalen Entwicklungsumgebung müssen Sie die gcloud CLI installieren und initialisieren.
Verwenden Sie den Befehlgcloud projects create, um ein Cloud-Projekt zu erstellen:gcloud projects create PROJECT_ID
APIs aktivieren
Für alle Chat-Apps muss die Google Chat API aktiviert sein. Je nachdem, wie Ihre Chat-App aufgebaut ist, müssen Sie möglicherweise andere APIs aktivieren. Wenn Sie beispielsweise Ihre Chat-App mit Google Cloud Functions erstellt haben, aktivieren Sie die Cloud Build API, die Cloud Functions API, die Pub/Sub API, die Cloud Logging API, die Artifact Registry API und die Cloud Run API. Damit die migrierte App funktioniert, sollten Sie im neuen Cloud-Projekt dieselben APIs aktivieren, die im alten Cloud-Projekt aktiviert sind.
So aktivieren Sie eine API:
Google Cloud Console
- Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü > Weitere Produkte > Google Workspace > Produktbibliothek.
- Klicken Sie auf die API, die Sie aktivieren möchten.
- Klicken Sie auf Aktivieren.
- Wenn Sie weitere APIs aktivieren möchten, wiederholen Sie diese Schritte.
Google Cloud CLI
- Installieren oder öffnen Sie die Google Cloud-Befehlszeile (CLI).
-
Führen Sie den Befehl
services enableaus und geben Sie an, welchen API-Dienst Sie aktivieren möchten.gcloud services enable API_SERVICE_ID
Chat API konfigurieren
In Ihrem neuen Cloud-Projekt müssen Sie mit der Chat API den Namen, die Beschreibung und das Symbol Ihrer Chat-App angeben. Weitere Informationen finden Sie unter Chat API konfigurieren.
OAuth-Zustimmungsbildschirm konfigurieren
Möglicherweise müssen Sie den OAuth-Zustimmungsbildschirm für Ihr Cloud-Projekt konfigurieren. Wenn Sie zuvor OAuth 2.0 für die Autorisierung verwendet haben, verwenden Sie dieselben Zugriffsbereiche.
- Klicken Sie in der Google Cloud Console auf das Dreistrich-Menü > > Branding.
- Wenn Sie die bereits konfiguriert haben, können Sie die folgenden Einstellungen für den OAuth-Zustimmungsbildschirm unter Branding, Zielgruppe und Datenzugriff konfigurieren. Wenn Sie die Meldung Noch nicht konfiguriert sehen, klicken Sie auf Jetzt starten:
- Geben Sie unter App-Informationen im Feld App-Name einen App-Namen ein.
- Wählen Sie unter E-Mail-Adresse des Nutzersupports eine Support-E-Mail-Adresse aus, über die Nutzer Sie mit Fragen zu ihrer Einwilligung kontaktieren können.
- Klicken Sie auf Weiter.
- Wählen Sie unter Zielgruppe den Nutzertyp für Ihre App aus.
- Klicken Sie auf Weiter.
- Geben Sie unter Kontaktinformationen eine E-Mail-Adresse ein, unter der Sie über Änderungen an Ihrem Projekt informiert werden können.
- Klicken Sie auf Weiter.
- Lesen Sie unter Fertigstellen die Nutzerdatenrichtlinie für Google API-Dienste und wählen Sie dann Ich akzeptiere die Richtlinie zu Nutzerdaten für Google API-Dienste aus, wenn Sie zustimmen.
- Klicken Sie auf Weiter.
- Klicken Sie auf Erstellen.
- Wenn Sie als Nutzertyp Extern ausgewählt haben, fügen Sie Testnutzer hinzu:
- Klicken Sie auf Zielgruppe.
- Klicken Sie unter Testnutzer auf Nutzer hinzufügen.
- Geben Sie Ihre E-Mail-Adresse und die E-Mail-Adressen aller anderen autorisierten Testnutzer ein und klicken Sie auf Speichern.
Wenn Sie eine App für die Verwendung außerhalb Ihrer Google Workspace-Organisation erstellen, klicken Sie auf Datenzugriff > Umfang hinzufügen oder entfernen. Wir empfehlen die folgenden Best Practices für die Auswahl von Bereichen:
- Wählen Sie die Bereiche aus, die die für Ihre App erforderliche Mindestzugriffsebene bieten. Eine Liste der verfügbaren Bereiche finden Sie unter OAuth 2.0-Bereiche für Google APIs.
- Sehen Sie sich die Bereiche in den drei Abschnitten an: Nicht vertrauliche Bereiche, vertrauliche Bereiche und eingeschränkte Bereiche. Versuchen Sie, für alle Bereiche, die in den Abschnitten „Meine vertraulichen Bereiche“ oder „Meine eingeschränkten Bereiche“ aufgeführt sind, alternative nicht vertrauliche Bereiche zu finden, um unnötige zusätzliche Überprüfungen zu vermeiden.
- Für einige Zugriffsbereiche ist eine zusätzliche Überprüfung durch Google erforderlich. Bei Apps, die nur intern von Ihrer Google Workspace-Organisation verwendet werden, sind die Bereiche nicht auf dem Einwilligungsbildschirm aufgeführt. Die Verwendung eingeschränkter oder vertraulicher Bereiche erfordert keine weitere Überprüfung durch Google. Weitere Informationen finden Sie unter Kategorien für den Geltungsbereich.
- Wählen Sie die für Ihre App erforderlichen Bereiche aus und klicken Sie auf Speichern.
Weitere Informationen zum Konfigurieren der OAuth-Einwilligung finden Sie unter Einführung in .
Chat-App im neuen Cloud-Projekt neu bereitstellen
Je nachdem, ob Ihre Chat-App mit Apps Script, AppSheet oder einem anderen Verbindungstyp wie Python oder Java erstellt wurde, unterscheidet sich die Neubereitstellung der Chat-App ein wenig. In beiden Fällen müssen Sie nicht den gesamten Code neu erstellen, aber einige Änderungen vornehmen.
Logik der Chat App migrieren
Je nach Architektur Ihrer Chat-App müssen Sie möglicherweise auch andere Dienste in das neue Cloud-Projekt migrieren:
- Bei HTTP-Apps müssen Sie auch den Rest der App-Logik migrieren, die mit Cloud Functions, Cloud Run oder App Engine erstellt wurde.
- Bei Konversations-Chat-Apps, die natürliche Sprache verwenden, müssen Sie auch die Dialogflow-Agents migrieren.
- Bei Chat-Apps, die hinter einer Firewall erstellt wurden, müssen Sie auch die Pub/Sub-Themen migrieren.
Interaktive Funktionen im neuen Cloud-Projekt konfigurieren
Wenn Sie Ihre Chat-App, die in einer Sprache wie Python oder Java erstellt wurde, neu bereitstellen möchten, konfigurieren Sie die Chat-App in Ihrem neuen Cloud-Projekt.
Informationen zum Konfigurieren interaktiver Funktionen finden Sie unter Nutzerinteraktionen empfangen und darauf reagieren.
Apps Script-Chat-App neu bereitstellen
Wenn Sie Ihre mit Apps Script erstellte Chat-App neu bereitstellen möchten, ändern Sie die Cloud-Projektnummer, die mit dem Apps Script-Projekt verknüpft ist, in die Projektnummer, die zu Ihrem neuen Cloud-Projekt gehört. Kopieren Sie dann die Bereitstellungs-ID Ihres Apps Script und fügen Sie sie in die Konfigurationsseite der Chat-App in der Google Cloud Console ein.
Cloud-Projektnummer kopieren
- Klicken Sie in der Google Cloud Console auf das Dreipunkt-Menü > IAM und Verwaltung > Einstellungen.
- Kopieren Sie den Wert aus dem Feld Projektnummer.
Google Cloud-Projektnummer in Ihrem Apps Script-Projekt festlegen
Rufen Sie Apps Script auf.
Klicken Sie im Apps Script-Projekt der Chat App auf Projekteinstellungen .
Klicken Sie unter Google Cloud Platform-Projekt (GCP-Projekt) auf Projekt ändern.
Fügen Sie unter GCP-Projektnummer die Google Cloud-Projektnummer ein.
Klicken Sie auf Projekt festlegen.
Bereitstellungs-ID Ihres Apps Script-Projekts kopieren
- Klicken Sie rechts oben in Apps Script auf Bereitstellen > Bereitstellungen verwalten.
- Klicken Sie unter Deployment-ID auf Kopieren.
- Klicken Sie auf Fertig.
Chat-App neu konfigurieren und bereitstellen
Suchen Sie in der Google Cloud Console nach „Google Chat API“ und klicken Sie auf Google Chat API und dann auf Verwalten.
Klicken Sie auf den Tab Konfiguration und geben Sie die folgenden erforderlichen Informationen ein:
- App-Name: Der Name, den Nutzer verwenden, wenn sie mit Ihrer Chat-App interagieren.
- Avatar-URL: Eine HTTPS-URL, die auf ein quadratisches Grafikbild (z. B. PNG oder JPEG) mit mindestens 128 x 128 Pixeln verweist, das als Avatar für Ihre Chat-App angezeigt wird.
- Beschreibung: Eine Beschreibung des beabsichtigten Zwecks der Chat-App, die unter dem Namen Ihrer Chat-App angezeigt wird.
Wenn Sie interaktive Funktionen aktivieren möchten, klicken Sie auf die Ein/Aus-Schaltfläche Interaktive Funktionen aktivieren, damit Nutzer mit Ihrer Chat-App interagieren können:
Wählen Sie unter „Verbindungseinstellungen“ die Option Apps Script-Projekt aus.
Fügen Sie in das Feld Deployment ID (Bereitstellungs-ID) die zuvor kopierte Bereitstellungs-ID ein.
Informationen zur restlichen Konfiguration finden Sie in der Tabelle unter Chat-App im neuen Cloud-Projekt konfigurieren.
Klicken Sie auf Speichern.
AppSheet-Chat-App neu bereitstellen
Wenn Sie Ihre mit AppSheet erstellte Chat-App in Ihrem neuen Cloud-Projekt neu bereitstellen möchten, kopieren Sie die App in das neue Cloud-Projekt.
Dienstkonto aktualisieren
Wenn sich Ihre Chat-App als App authentifiziert und ein Dienstkonto verwendet, um Google APIs aufzurufen, aktualisieren Sie die Dienstkontodetails der Chat-App. Weitere Informationen finden Sie unter Als Chat-App authentifizieren.
Chat App teilen
Bevor Ihre Chat-App für Nutzer in der neuen Organisation verfügbar ist, muss Ihr Administrator möglicherweise den Zugriff auf die Chat-App manuell zulassen. Weitere Informationen finden Sie unter So installieren Google Workspace-Administratoren Chat-Apps.
Zur neuen Chat App wechseln
Nachdem die Chat-App zur neuen Organisation migriert wurde, ist es an der Zeit, sie bekannt zu machen. Fügen Sie sie Gruppenbereichen oder Direktnachrichten hinzu und entfernen Sie dann die alte Chat App, damit Nutzer nur noch über die migrierte Chat App Nachrichten senden können.
Neue Chat App zu Gruppenbereichen in Google Chat hinzufügen
Öffnen Sie Google Chat.
Klicken Sie auf eine Direktnachricht oder einen Gruppenbereich.
Klicken Sie auf das Drop-down-Menü neben dem Namen des Gruppenbereichs oder der Person und wählen Sie Apps und Integrationen aus.
Klicken Sie auf Apps hinzufügen.
Geben Sie den Namen der App ein, wählen Sie sie aus der Liste aus und klicken Sie auf Hinzufügen.
Wiederholen Sie diese Schritte für jeden Gruppenbereich oder jede Direktnachricht, der bzw. der Sie die Chat-App hinzufügen möchten.
Alte Chat App aus Chatbereichen entfernen
Öffnen Sie Google Chat.
Klicken Sie auf eine Direktnachricht oder einen Gruppenbereich.
Klicken Sie auf das Drop-down-Menü neben dem Namen des Gruppenbereichs oder der Person und wählen Sie Apps und Integrationen aus.
Klicken Sie neben der alten, nicht migrierten Chat-App auf das Dreipunkt-Menü und dann auf Aus Gruppenbereich entfernen.
Wiederholen Sie diese Schritte für jeden Gruppenbereich oder jede Direktnachricht, aus der Sie die alte Chat-App entfernen möchten.
Alte Chat App deaktivieren
Wenn Sie verhindern möchten, dass Nutzer die alte Chat-App verwenden, und sie stattdessen zur Nutzung der neuen Chat-App anregen möchten, deaktivieren Sie die alte Chat-App und widerrufen Sie die Veröffentlichung im Google Workspace Marketplace.