Wenn Sie Google Workspace-Organisationen zusammenführen, müssen Sie Ihre Chat-App möglicherweise migrieren, damit sie weiterhin funktioniert.
Erkundigen Sie sich vor der Migration der Chat-Anwendung beim Administrator Ihrer Organisation, ob die Verwaltungseinstellungen Auswirkungen auf die Anwendung haben. Wenn Sie eine Administratoreinstellung ändern, steht möglicherweise die volle Funktionalität Ihrer Chat-App wieder zur Verfügung und die Migration ist nicht erforderlich. Beispielsweise muss der Google Workspace-Administrator Ihre Chat-Anwendung möglicherweise auf eine Zulassungsliste setzen oder Nutzern erlauben, Chat-Apps zu installieren. Weitere Informationen finden Sie unter Bestimmen, ob Google Chat-Anwendungen nach dem Zusammenführen von Google Workspace-Organisationen migriert werden müssen.
Nachdem Sie festgestellt haben, dass Sie Ihre Chat-Anwendung migrieren müssen, führen Sie die folgenden drei Schritte aus:
- Richten Sie die Umgebung für Ihre Chat-App ein. Erstellen Sie dazu in der zusammengeführten Organisation ein Google Cloud-Projekt, aktivieren Sie APIs und konfigurieren Sie gegebenenfalls den OAuth 2.0-Zustimmungsbildschirm.
- Stellen Sie die Chat-App aus dem neuen Cloud-Projekt noch einmal bereit.
- Fügen Sie die neu erstellte Chat-App Chatbereichen 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-Anwendung in der zusammengeführten Google Workspace-Organisation aktivieren, sorgen Sie dafür, dass Nutzer und Gruppen, denen Sie Zugriff auf die Chat-Anwendung erlauben, dies ohne Fehler tun können.
Cloud-Projekt erstellen
Google Cloud Console
- Öffnen Sie in der Google Cloud Console das Dreistrich-Menü > IAM und Verwaltung > Projekt erstellen.
-
Geben Sie im Feld Projektname einen aussagekräftigen Namen für das 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 daher eine ID aus, die Ihren Anforderungen für die gesamte Lebensdauer des Projekts entspricht.
- Klicken Sie im Feld Standort auf Durchsuchen, um potenzielle Standorte für Ihr Projekt aufzurufen. Klicken Sie danach auf Auswählen.
- Klicken Sie auf Erstellen. Die Google Cloud Console ruft die Dashboard-Seite auf und Ihr Projekt wird innerhalb weniger Minuten erstellt.
gcloud-CLI
Greifen Sie in einer der folgenden Entwicklungsumgebungen auf die Google Cloud CLI (gcloud) zu:
-
Cloud Shell: Aktivieren Sie Cloud Shell, um ein Online-Terminal zu verwenden, bei dem die gcloud CLI bereits eingerichtet ist.
Cloud Shell aktivieren -
Lokale Shell: Um eine lokale Entwicklungsumgebung zu verwenden, müssen Sie die gcloud CLI installieren und initialize.
Verwenden Sie den Befehl „gcloud projects create“, um ein Cloud-Projekt zu erstellen:
Ersetzen Sie PROJECT_ID, indem Sie die ID des Projekts festlegen, das Sie erstellen möchten.gcloud projects create PROJECT_ID
APIs aktivieren
Für alle Chat-Apps muss die Google Chat API aktiviert sein. Je nachdem, wie Ihre Chat-Anwendung erstellt wird, müssen Sie möglicherweise weitere 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 Anwendung 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
- Öffnen Sie in der Google Cloud Console das Dreistrich-Menü > Weitere Produkte > Google Workspace > Produktbibliothek.
- Klicken Sie auf die API, die Sie aktivieren möchten.
- Klicken Sie auf Aktivieren.
- Wiederholen Sie diese Schritte, um weitere APIs zu aktivieren.
Google Cloud CLI
- Installieren oder öffnen Sie die Google Cloud-Befehlszeile.
-
Führen Sie den Befehl
services enableaus und geben Sie an, welcher API-Dienst aktiviert werden soll.gcloud services enable API_SERVICE_ID
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 für die Autorisierung.
- Rufen Sie in der Google Cloud Console das Menü auf > APIs und Dienste > OAuth-Zustimmungsbildschirm.
- Wählen Sie den Nutzertyp für Ihre App aus und klicken Sie auf Erstellen.
- Füllen Sie das App-Registrierungsformular aus und klicken Sie dann auf Speichern und fortfahren.
Wenn Sie eine Anwendung für die Verwendung außerhalb Ihrer Google Workspace-Organisation erstellen, klicken Sie auf Bereiche hinzufügen oder entfernen. Wir empfehlen die folgenden Best Practices bei der Auswahl von Bereichen:
- Wählen Sie die Bereiche mit der für die Anwendung erforderlichen Mindestzugriffsebene aus. Eine Liste der verfügbaren Bereiche finden Sie unter OAuth 2.0-Bereiche für Google APIs.
- Überprüfen Sie die Bereiche, die in jedem der drei Abschnitte aufgeführt sind: nicht vertrauliche Bereiche, sensible Bereiche und eingeschränkte Bereiche. Versuchen Sie für alle Bereiche, die in den Abschnitten „Meine vertraulichen Bereiche“ oder „Ihre eingeschränkten Bereiche“ aufgeführt sind, alternative, nicht vertrauliche Bereiche zu ermitteln, um unnötige zusätzliche Prüfungen zu vermeiden.
- Einige Bereiche erfordern eine zusätzliche Überprüfung durch Google. Bei Anwendungen, die nur intern von Ihrer Google Workspace-Organisation verwendet werden, werden Bereiche auf dem Zustimmungsbildschirm nicht aufgeführt und die Verwendung von eingeschränkten oder vertraulichen Bereichen erfordert keine weitere Prüfung von Google. Weitere Informationen finden Sie unter Bereichskategorien.
- Nachdem Sie die für Ihre Anwendung erforderlichen Bereiche ausgewählt haben, klicken Sie auf Speichern und fortfahren.
- Wenn Sie als Nutzertyp Extern ausgewählt haben, fügen Sie Testnutzer hinzu:
- Klicken Sie unter Testnutzer auf Nutzer hinzufügen.
- Geben Sie Ihre E-Mail-Adresse und alle weiteren autorisierten Testnutzer ein und klicken Sie dann auf Speichern und fortfahren.
- Prüfen Sie die Zusammenfassung der App-Registrierung. Wenn Sie Änderungen vornehmen möchten, klicken Sie auf Bearbeiten. Wenn die Anwendungsregistrierung in Ordnung ist, klicken Sie auf Zurück zum Dashboard.
Stellen Sie die Chat-App noch einmal im neuen Cloud-Projekt bereit
Je nachdem, ob Ihre Chat-App mit Apps Script, AppSheet oder einem anderen Verbindungstyp wie Python oder Java erstellt wurde, unterscheidet sich die erneute Bereitstellung der Chat-App etwas. In beiden Fällen müssen Sie nicht den gesamten Code neu erstellen, aber einige Änderungen vornehmen.
Logik der Chat-App migrieren
Abhängig von der Architektur Ihrer Chat-Anwendung müssen Sie möglicherweise weitere Dienste zum neuen Cloud-Projekt migrieren:
- Bei HTTP-Anwendungen müssen Sie auch die restliche Anwendungslogik migrieren, die mit Cloud Functions, Cloud Run oder App Engine erstellt wurde.
- Für dialogorientierte Chat-Anwendungen, die natürliche Sprache verwenden, müssen Sie auch die Dialogflow-Agents migrieren.
- Bei Chat-Anwendungen, die hinter einer Firewall erstellt werden, müssen Sie auch die Pub/Sub-Themen migrieren.
Chat-App im neuen Cloud-Projekt konfigurieren
Wenn Sie die Chat-App, die mit einer Sprache wie Python oder Java erstellt wurde, noch einmal bereitstellen möchten, konfigurieren Sie sie in Ihrem neuen Cloud-Projekt.
Suchen Sie in der Google Cloud Console nach „Google Chat API“, 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 Bild (z. B. PNG oder JPEG) verweist und mindestens 128 × 128 Pixel groß ist und als Avatar für Ihre Chat-App angezeigt wird.
- Beschreibung: Eine Beschreibung des Zwecks der Chat-App. Sie wird unter dem Namen der Chat-App angezeigt.
Klicken Sie zum Aktivieren der interaktiven Funktionen auf die Ein/Aus-Schaltfläche Interaktive Funktionen aktivieren, damit Nutzer mit Ihrer Chat-App interagieren können. Verwenden Sie die folgende Tabelle, um die Konfiguration abzuschließen:
Field Beschreibung Funktionalität Eine Reihe von Feldern, über die festgelegt wird, wie die Chat-App mit Nutzern interagieren kann: - 1:1-Nachrichten empfangen: Nutzer können die Chat App direkt in Google Chat finden und ihnen Nachrichten senden.
- Gruppenbereichen und Gruppenunterhaltungen beitreten: Nutzer können die Chat App zu Gruppenbereichen und Gruppenunterhaltungen hinzufügen.
Verbindungseinstellungen Der Endpunkt für die Chat-App, der einer der folgenden ist: - App-URL: Ein HTTPS-Endpunkt, der die Implementierung der Chat-App hostet.
- Apps Script-Projekt: Eine Bereitstellungs-ID für ein Apps Script-Projekt, in dem eine Chat-App implementiert ist.
- Name des Cloud Pub/Sub-Themas: Ein Pub/Sub-Thema, das die Chat-App als Endpunkt abonniert.
- Dialogflow: Registriert die Chat-App bei einer Dialogflow-Integration. Weitere Informationen finden Sie unter Dialogflow Google Chat-App erstellen, die natürliche Sprache versteht.
Slash-Befehle Befehle, die Nutzern in Google Chat angezeigt werden können. Damit können Nutzer die Hauptaktionen der Chat-App in Google Chat sehen und eine bestimmte Aktion auswählen, mit der sie interagieren möchten. Weitere Informationen finden Sie unter Slash-Befehle als Chat-App beantworten. Linkvorschauen URL-Muster, die von der Chat-App erkannt und für die zusätzliche Inhalte bereitgestellt werden, wenn Nutzer Links senden. Weitere Informationen finden Sie unter Vorschaulinks. Sichtbarkeit Bis zu fünf Personen oder eine oder mehrere Google-Gruppen, die Ihre Chat-App aufrufen und installieren können. Verwenden Sie dieses Feld, um Ihre Chat-App zu testen oder für Ihr Team freizugeben. Weitere Informationen finden Sie unter Sichtbarkeit und Veröffentlichungseinstellungen für Ihre Chat-App. Klicken Sie das Kästchen Fehler in Logging protokollieren an, damit Fehler in Cloud Logging protokolliert werden, wenn die Chat-Anwendung einen Fehler zurückgibt. Weitere Informationen finden Sie unter Abfragefehlerlogs für Chat-Apps.
Klicken Sie auf Speichern. Wenn Sie die Konfiguration der Chat-Anwendung speichern, ist sie für die angegebenen Nutzer in Ihrer Google Workspace-Organisation verfügbar.
Apps Script-Chat-App noch einmal bereitstellen
Wenn Sie die mit Apps Script erstellte Chat-App noch einmal bereitstellen möchten, ändern Sie die Cloud-Projektnummer, mit der das Apps Script-Projekt verknüpft ist, in die Projektnummer Ihres neuen Cloud-Projekts. Kopieren Sie dann Ihre Apps Script-Bereitstellungs-ID und fügen Sie sie in der Google Cloud Console auf der Konfigurationsseite der Chat-App ein.
Cloud-Projektnummer kopieren
- Öffnen Sie in der Google Cloud Console das Dreistrich-Menü > IAM und Verwaltung > Einstellungen.
- Kopieren Sie den Wert im Feld Projektnummer.
Google Cloud-Projektnummer im 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) auf Projekt ändern.
Fügen Sie unter GCP-Projektnummer die Google Cloud-Projektnummer ein.
Klicken Sie auf Projekt festlegen.
Bereitstellungs-ID des Apps Script-Projekts kopieren
- Klicken Sie rechts oben in Apps Script auf Bereitstellen > Bereitstellungen verwalten.
- Klicken Sie unter Bereitstellungs-ID auf Kopieren.
- Klicken Sie auf Fertig.
Chat-App neu konfigurieren und neu bereitstellen
Suchen Sie in der Google Cloud Console nach „Google Chat API“, 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 Bild (z. B. PNG oder JPEG) verweist und mindestens 128 × 128 Pixel groß ist und als Avatar für Ihre Chat-App angezeigt wird.
- Beschreibung: Eine Beschreibung des Zwecks der Chat-App. Sie wird unter dem Namen der Chat-App angezeigt.
Klicken Sie zum Aktivieren der interaktiven Funktionen 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 Bereitstellungs-ID die zuvor kopierte Bereitstellungs-ID ein.
Informationen zum Abschließen der Konfiguration finden Sie in der Tabelle unter Chat-App im neuen Cloud-Projekt konfigurieren.
Klicken Sie auf Speichern.
AppSheet Chat-App noch einmal bereitstellen
Wenn Sie die mit AppSheet erstellte Chat-App in Ihrem neuen Cloud-Projekt noch einmal bereitstellen möchten, kopieren Sie die Anwendung in das neue Cloud-Projekt.
Dienstkonto aktualisieren
Wenn sich Ihre Chat-Anwendung als Anwendung authentifiziert und ein Dienstkonto verwendet, um Google APIs aufzurufen, aktualisieren Sie die Dienstkontodetails der Chat-Anwendung. Weitere Informationen finden Sie unter Als Chat-App authentifizieren.
Chat-App teilen
Bevor die Chat-Anwendung für Nutzer in der neuen Organisation verfügbar ist, muss Ihr Administrator den Zugriff auf die Chat-Anwendung möglicherweise manuell zulassen. Weitere Informationen finden Sie unter Wie Google Workspace-Administratoren Chat-Anwendungen installieren.
Zur neuen Google Chat App wechseln
Nachdem die Chat-Anwendung in die neue Organisation migriert wurde, kann sie veröffentlicht werden. Fügen Sie sie Chatbereichen oder Direktnachrichten hinzu und entfernen Sie dann die alte Chat-App daraus, damit Nachrichten nur an die migrierte Chat-App gesendet werden.
Neue Chat-App zu Chatbereichen 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 dann auf Hinzufügen.
Wiederholen Sie diese Schritte für jeden Gruppenbereich oder jede Direktnachricht, dem 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 Weitere Optionen und dann auf Aus Gruppenbereich entfernen.
Wiederholen Sie diese Schritte für jeden Gruppenbereich oder jede Direktnachricht, aus dem Sie die alte Chat-App entfernen möchten.
Alte Google Chat App deaktivieren
Wenn Sie verhindern möchten, dass Nutzer die alte Chat-App verwenden, und sie zur Verwendung der neuen Chat-App ermutigen möchten, deaktivieren Sie die alte Chat-App und heben Sie ihre Veröffentlichung im Google Workspace Marketplace auf.