Google Chat-App migrieren

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, sollten Sie sich bei Ihrem Administrator erkundigen, ob administrative Einstellungen die Migration beeinträchtigen. Wenn Sie eine Administratoreinstellung ändern, kann es sein, dass die Chat-App wieder voll funktionsfähig ist und eine Migration nicht mehr erforderlich ist. Ihr Google Workspace-Administrator muss Ihre Chat-App möglicherweise auf eine Zulassungsliste setzen oder Nutzern erlauben, Chat-Apps zu installieren. Weitere Informationen finden Sie im Hilfeartikel Müssen Google Chat-Apps nach dem Zusammenführen von Google Workspace-Organisationen migriert werden?.

Wenn Sie feststellen, dass Sie Ihre Chat-App migrieren müssen, führen Sie die folgenden drei Schritte aus:

  1. Richten Sie die Umgebung für Ihre Chat-App ein, indem Sie ein Google Cloud-Projekt in der zusammengeführten Organisation erstellen, APIs aktivieren und gegebenenfalls den OAuth 2.0-Zustimmungsbildschirm konfigurieren.
  2. Stellen Sie Ihre Chat-App noch einmal über das neue Cloud-Projekt bereit.
  3. 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 Zugriff auf die Chat-App gewähren, dies ohne Fehler tun.

Cloud-Projekt erstellen

Google Cloud Console

  1. Klicken Sie in der Google Cloud Console auf das Menü  > IAM & Verwaltung > Projekt erstellen.

    Zur Seite „Projekt erstellen“

  2. Geben Sie im Feld Projektname einen aussagekräftigen Namen für Ihr Projekt ein.

    Optional: Wenn Sie die Projekt-ID bearbeiten möchten, klicken Sie auf 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.

  3. Klicken Sie im Feld Speicherort auf Durchsuchen, um mögliche Speicherorte für Ihr Projekt aufzurufen. Klicken Sie danach auf Auswählen.
  4. Klicken Sie auf Erstellen. In der Google Cloud Console wird die Seite „Dashboard“ aufgerufen 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 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 zum Erstellen eines Cloud-Projekts den Befehl gcloud projects create: 
    gcloud projects create PROJECT_ID
     Ersetzen Sie PROJECT_ID durch die ID des Projekts, das Sie erstellen möchten.

APIs aktivieren

Für alle Chat-Apps muss die Google Chat API aktiviert sein. Je nachdem, wie Ihre Chat-App erstellt wurde, müssen Sie möglicherweise andere APIs aktivieren. Wenn Sie Ihre Chat-App beispielsweise 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. Als Best Practice sollten Sie dieselben APIs im neuen Cloud-Projekt aktivieren, die im alten Cloud-Projekt aktiviert sind, damit die migrierte App funktioniert.

So aktivieren Sie eine API:

Google Cloud Console

  1. Rufen Sie in der Google Cloud Console das Menü  > Weitere Produkte > Google Workspace > Produktbibliothek auf.

    Zur Produktbibliothek

  2. Klicken Sie auf die API, die Sie aktivieren möchten.
  3. Klicken Sie auf Aktivieren.
  4. Wenn Sie weitere APIs aktivieren möchten, wiederholen Sie diese Schritte.

Google Cloud CLI

  1. Installieren oder öffnen Sie die Google Cloud-Befehlszeile.

  2. Führen Sie den Befehl services enable aus und geben Sie an, welcher API-Dienst aktiviert werden soll.

    gcloud services enable API_SERVICE_ID

Chat API konfigurieren

In Ihrem neuen Cloud-Projekt müssen Sie die Chat API verwenden, um den Namen, die Beschreibung und das Symbol Ihrer Chat-App anzugeben. Informationen zum Konfigurieren dieser Details finden Sie unter Chat API 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 Autorisierungsbereiche.

  1. Rufen Sie in der Google Cloud Console das Menü  > > Branding auf.

    Zu Branding

  2. 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:
    1. Geben Sie unter App-Informationen für App-Name einen App-Namen ein.
    2. 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.
    3. Klicken Sie auf Weiter.
    4. Wählen Sie unter Zielgruppe den Nutzertyp für Ihre App aus.
    5. Klicken Sie auf Weiter.
    6. Geben Sie unter Kontaktdaten eine E-Mail-Adresse ein, unter der Sie über Änderungen an Ihrem Projekt benachrichtigt werden können.
    7. Klicken Sie auf Weiter.
    8. Sehen Sie sich unter Fertigstellen die Nutzerdatenrichtlinie für Google API-Dienste an. Wenn Sie damit einverstanden sind, wählen Sie Ich stimme der Nutzerdatenrichtlinie für Google API-Dienste zu aus.
    9. Klicken Sie auf Weiter.
    10. Klicken Sie auf Erstellen.
    11. Wenn Sie Extern als Nutzertyp ausgewählt haben, fügen Sie Testnutzer hinzu:
      1. Klicken Sie auf Zielgruppe.
      2. Klicken Sie unter Testnutzer auf Nutzer hinzufügen.
      3. Geben Sie Ihre E‑Mail-Adresse und die E‑Mail-Adressen aller anderen autorisierten Testnutzer ein und klicken Sie auf Speichern.

  3. Wenn Sie eine App für die Verwendung außerhalb Ihrer Google Workspace-Organisation erstellen, klicken Sie auf Datenzugriff > Bereiche hinzufügen oder entfernen. Wir empfehlen die folgenden Best Practices für die Auswahl von Bereichen:

    • Wählen Sie die Bereiche aus, die das für Ihre App erforderliche Mindestzugriffsniveau bieten. Eine Liste der verfügbaren Bereiche finden Sie unter OAuth 2.0-Bereiche für Google APIs.
    • Sehen Sie sich die Bereiche an, die in den drei Abschnitten aufgeführt sind: nicht vertrauliche Bereiche, vertrauliche Bereiche und eingeschränkte Bereiche. Suchen Sie für alle Bereiche, die in den Abschnitten „Ihre vertraulichen Bereiche“ oder „Ihre eingeschränkten Bereiche“ aufgeführt sind, nach alternativen, nicht vertraulichen Bereichen, um unnötige zusätzliche Überprüfungen zu vermeiden.
    • Für einige Bereiche sind zusätzliche Überprüfungen durch Google erforderlich. Bei Apps, die nur intern von Ihrer Google Workspace-Organisation verwendet werden, werden 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 Bereichskategorien.
  4. Nachdem Sie die für Ihre App erforderlichen Bereiche ausgewählt haben, klicken Sie auf Speichern.

Weitere Informationen zum Konfigurieren der OAuth-Zustimmung finden Sie unter Erste Schritte mit der .

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 erneute Bereitstellung Ihrer Chat-App geringfügig. In beiden Fällen müssen Sie nicht den gesamten Code neu erstellen, aber einige Änderungen sind erforderlich.

Chat App-Logik migrieren

Je nach Architektur Ihrer Chat-App müssen Sie möglicherweise andere Dienste in das neue Cloud-Projekt migrieren:

  • Bei HTTP-Apps müssen Sie auch die restliche 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.
  • Für 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 mit einer Sprache wie Python oder Java erstellt wurde, noch einmal 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, mit der das Apps Script-Projekt verknüpft ist, in die Projektnummer Ihres neuen Cloud-Projekts. Kopieren Sie dann die Bereitstellungs-ID Ihres Apps Script-Projekts und fügen Sie sie auf der Seite für die Chat-App-Konfiguration in der Google Cloud Console ein.

Cloud-Projektnummer kopieren

  1. Rufen Sie in der Google Cloud Console das Menü  > IAM & Verwaltung > Einstellungen auf.

    Weiter zur Seite „IAM & Verwaltung“

  2. Kopieren Sie den Wert aus dem Feld Projektnummer.

Google Cloud-Projektnummer in Ihrem Apps Script-Projekt festlegen

  1. Rufen Sie Apps Script auf.

    Zu Apps Script wechseln

  2. Klicken Sie im Apps Script-Projekt der Chat App auf Projekteinstellungen .

  3. Klicken Sie unter Google Cloud Platform-Projekt (GCP-Projekt) auf Projekt ändern.

  4. Fügen Sie die Google Cloud-Projektnummer in GCP-Projektnummer ein.

  5. Klicken Sie auf Projekt festlegen.

Bereitstellungs-ID Ihres Apps Script-Projekts kopieren

  1. Klicken Sie rechts oben in Apps Script auf Bereitstellen > Bereitstellungen verwalten.
  2. Klicken Sie unter Deployment-ID auf Kopieren.
  3. Klicken Sie auf Fertig.

Chat-App neu konfigurieren und neu bereitstellen

  1. Suchen Sie in der Google Cloud Console nach „Google Chat API“, klicken Sie auf Google Chat API und dann auf Verwalten.

    Zur Chat API

  2. 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) mit einer Mindestgröße von 128 × 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 der Chat-App angezeigt wird.

  3. Wenn Sie interaktive Funktionen aktivieren möchten, klicken Sie auf den Schalter Interaktive Funktionen aktivieren, damit Nutzer mit Ihrer Chat-App interagieren können:

  4. Wählen Sie unter „Verbindungseinstellungen“ die Option Apps Script-Projekt aus.

  5. Fügen Sie die zuvor kopierte Bereitstellungs-ID in das Feld Bereitstellungs-ID ein.

  6. Informationen zum Abschließen der restlichen Konfiguration finden Sie in der Tabelle unter Chat-App im neuen Cloud-Projekt konfigurieren.

  7. Klicken Sie auf Speichern.

AppSheet-Chat-App noch einmal 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 Authentifizierung als Chat-App.

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 in der Google Workspace Marketplace-Dokumentation unter Zugriff für Google Workspace-Organisationen konfigurieren.

Zur neuen Chat App wechseln

Nachdem die Chat-App zur neuen Organisation migriert wurde, können Sie sie veröffentlichen. Fügen Sie sie Chat-Bereichen oder Direktnachrichten hinzu und entfernen Sie dann die alte Chat App, damit Nutzer nur noch Nachrichten an die migrierte Chat App senden.

Neue Chat App zu Chat-Gruppenbereichen hinzufügen

  1. Rufen Sie Google Chat auf.

    Google Chat öffnen

  2. Klicken Sie auf eine Direktnachricht oder einen Gruppenbereich.

  3. Klicken Sie auf das Drop-down-Menü neben dem Namen des Gruppenbereichs oder der Person und wählen Sie dann Apps und Integrationen aus.

  4. Klicken Sie auf Apps hinzufügen.

  5. Geben Sie den Namen der App ein, wählen Sie die App aus der Liste aus und klicken Sie auf Hinzufügen.

  6. Wiederholen Sie diese Schritte für jeden Gruppenbereich oder jede Direktnachricht, der bzw. die Sie die Chat App hinzufügen möchten.

Alte Chat App aus Chatbereichen entfernen

  1. Rufen Sie Google Chat auf.

    Google Chat öffnen

  2. Klicken Sie auf eine Direktnachricht oder einen Gruppenbereich.

  3. Klicken Sie auf das Drop-down-Menü neben dem Namen des Gruppenbereichs oder der Person und wählen Sie dann Apps und Integrationen aus.

  4. Klicken Sie neben der alten, nicht migrierten Chat App auf das Dreipunkt-Menü und dann auf Aus Gruppenbereich entfernen.

  5. Wiederholen Sie diese Schritte für jeden Bereich 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 dazu anregen möchten, die neue Chat-App zu verwenden, deaktivieren Sie die alte Chat-App und heben Sie die Veröffentlichung im Google Workspace Marketplace auf.