Google Chat-App migrieren

Wenn Sie Google Workspace-Organisationen zusammenführen, müssen Sie möglicherweise Ihre Chat-App migrieren, damit sie weiterhin funktioniert.

Bevor Sie Ihre Chat-App migrieren, fragen Sie den Administrator Ihrer Organisation, ob administrative Einstellungen sie beeinträchtigen. Wenn Sie eine administrative Einstellung ändern, kann die volle Funktionalität Ihrer Chat-App wiederhergestellt werden und eine Migration ist möglicherweise nicht erforderlich. Beispielsweise muss Ihr Google Workspace-Administrator Ihre Chat-App möglicherweise einer Zulassungsliste hinzufügen oder Nutzern erlauben, Chat-Apps zu installieren. Weitere Informationen finden Sie unter Ermitteln, ob Google Chat-Apps nach dem Zusammenführen von Google Workspace-Organisationen migriert werden müssen.

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 aus dem neuen Cloud-Projekt neu bereit.
  3. Fügen Sie die neu erstellte Chat-App zu 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-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. Gehen Sie in der Google Cloud Console zu „Menü“ > IAM und Verwaltung > Projekt erstellen.

    Zu „Projekt erstellen“

  2. Geben Sie im Feld Projektname einen beschreibenden 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.

  3. Klicken Sie im Feld Speicherort auf Durchsuchen, um mögliche Speicherorte für Ihr Projekt anzuzeigen. 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 den Befehl gcloud projects create, um ein Cloud-Projekt zu erstellen: 
    gcloud projects create PROJECT_ID
     Ersetzen Sie PROJECT_ID, indem Sie die ID für das Projekt festlegen, 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. Gehen Sie in der Google Cloud Console zu „Menü“ > APIs und Dienste > Bibliothek > Google Workspace.

    Zur API-Bibliothek

  2. Klicken Sie auf die API, die Sie aktivieren möchten.
  3. Klicken Sie auf Aktivieren.
  4. Wiederholen Sie diese Schritte, um weitere APIs zu aktivieren.

Google Cloud CLI

  1. Installieren oder öffnen Sie die Google Cloud Command Line Interface (CLI).

  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 für den Zugriff.

  1. Gehen Sie in der Google API Console zu „Menü“ > Google Auth Platform > Branding.

    Zum Branding

  2. Wenn Sie die Google Auth Platform bereits konfiguriert haben, können Sie die folgenden Einstellungen für den OAuth-Zustimmungsbildschirm unter Branding, Zielgruppe und Datenzugriff konfigurieren. Wenn die Meldung Google Auth Platform noch nicht konfiguriert angezeigt wird, klicken Sie auf Jetzt starten:
    1. Geben Sie unter Anwendungsinformationen im Feld Anwendungsname einen Anwendungsnamen ein.
    2. Wählen Sie unter E‑Mail-Adresse für Nutzersupport eine E‑Mail-Adresse für den Support aus, über die Nutzer Sie kontaktieren können, wenn sie Fragen zu ihrer Einwilligung haben.
    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, über die Sie über Änderungen an Ihrem Projekt benachrichtigt werden können.
    7. Klicken Sie auf Weiter.
    8. Lesen Sie unter Abschließen die Nutzerdatenrichtlinie für Google API-Dienste. Wenn Sie damit einverstanden sind, wählen Sie Ich akzeptiere die Richtlinie zu Nutzerdaten für Google API-Dienste aus.
    9. Klicken Sie auf Weiter.
    10. Klicken Sie auf Erstellen.
    11. Wenn Sie als Nutzertyp Extern 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 bei der Auswahl von Bereichen:

    • Wählen Sie die Bereiche aus, die das Mindestmaß an Zugriff bieten, das für Ihre App erforderlich ist. Eine Liste der verfügbaren Bereiche finden Sie unter OAuth 2.0-Bereiche für Google APIs.
    • Prüfen Sie die Bereiche, die in den drei Abschnitten aufgeführt sind: nicht sensible Bereiche, sensible Bereiche und eingeschränkte Bereiche. Suchen Sie für alle Bereiche, die in den "Ihre sensiblen Bereiche" oder "Ihre eingeschränkten Bereiche" aufgeführt sind, nach alternativen nicht sensiblen 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 die Bereiche nicht auf dem Zustimmungsbildschirm aufgeführt. Die Verwendung von eingeschränkten oder sensiblen Bereichen erfordert keine weitere Überprüfung durch Google. Weitere Informationen finden Sie unter Bereichskategorien.
  4. Klicken Sie nach der Auswahl der für Ihre App erforderlichen Bereiche auf Speichern.

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

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 etwas. 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 zum neuen Cloud-Projekt migrieren:

  • Bei HTTP-Apps müssen Sie auch die restliche App-Logik migrieren, die mit Cloud Run-Funktionen, 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 mit 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 Chat-App, die mit Apps Script erstellt wurde, 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 Ihre Apps Script-Bereitstellungs-ID und fügen Sie sie auf der Seite zur Chat-App-Konfiguration in der Google API Console ein.

Cloud-Projektnummer kopieren

  1. Gehen Sie in der Google API Console zu „Menü“ > IAM und Verwaltung > Einstellungen.

    Weiter zur Seite „IAM &Verwaltung“

  2. Kopieren Sie den Wert im Feld Projektnummer.

Google Cloud-Projektnummer im Apps Script-Projekt festlegen

  1. Gehen Sie zu Apps Script.

    Zu Apps Script

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

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

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

  5. Klicken Sie auf Projekt festlegen.

Bereitstellungs-ID des Apps Script-Projekts kopieren

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

Chat-App neu konfigurieren und bereitstellen

  1. Suchen Sie in der Google API Console nach „Google Chat API“ und 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:

    • Anwendungsname: Der Name, den Nutzer verwenden, wenn sie mit Ihrer Chat-App interagieren.
    • Avatar-URL: Eine HTTPS-URL, die auf ein quadratisches Grafikbild verweist (z. B. PNG oder JPEG) mit mindestens 128 × 128 Pixeln, 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.

  3. Wenn Sie interaktive Funktionen aktivieren möchten, klicken Sie auf die Schaltfläche Interaktive Funktionen aktivieren , mit der 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 dem Abschnitt Chat-App im neuen Cloud-Projekt konfigurieren.

  7. Klicken Sie auf Speichern.

AppSheet-Chat-App neu bereitstellen

Wenn Sie Ihre Chat-App, die mit AppSheet in Ihrem neuen Cloud-Projekt erstellt wurde, die App in das neue Cloud-Projekt kopieren möchten.

Dienstkonto aktualisieren

Wenn sich Ihre Chat-App als App authentifiziert und ein Dienstkonto verwendet, um Google APIs aufzurufen, aktualisieren Sie die Details des Dienstkontos 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 manuell den Zugriff auf die Chat-App 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, ist es an der Zeit, sie zu veröffentlichen. Fügen Sie sie zu Chatbereichen oder Direktnachrichten hinzu und entfernen Sie dann die alte Chat-App, damit Nutzer nur Nachrichten an die migrierte Chat-App senden.

Neue Chat-App zu Chatbereichen hinzufügen

  1. Gehen Sie zu Google Chat.

    Zu Google Chat

  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 sie aus der Liste aus und klicken Sie dann auf Hinzufügen.

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

Alte Chat-App aus Chatbereichen entfernen

  1. Gehen Sie zu Google Chat.

    Zu Google Chat

  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 Weitere Optionen und dann auf Aus Gruppenbereich entfernen.

  5. 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

Damit Nutzer die alte Chat-App nicht mehr verwenden und die neue Chat-App verwenden, deaktivieren Sie die alte Chat-App und entfernen Sie sie aus dem Google Workspace Marketplace.