Wenn Sie Google Workspace-Organisationen zusammenführen, müssen Sie möglicherweise Ihre Chat-App, damit sie weiter funktioniert.
Erkundigen Sie sich vor der Migration Ihrer Chat-App Administrator der Organisation überprüfen, ob die Administratoreinstellungen beeinflussen. Durch das Ändern einer Administratoreinstellung werden möglicherweise vollständige der Chat-App hinzufügen und die Migration unnötig. Vielleicht hat Ihr Google Workspace-Administrator Chat-App auf eine Zulassungsliste setzen, Nutzer dürfen Chat-Apps installieren. Weitere Informationen finden Sie unter Ermitteln, ob Google Chat-Apps nach dem Zusammenführen von Google Workspace-Organisationen migriert werden müssen
Nachdem Sie festgestellt haben, dass Sie Ihre Für die Chat-App sind die folgenden drei Schritte erforderlich:
- 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 OAuth 2.0-Zustimmungsbildschirm konfigurieren.
- Stellen Sie die Chat-App über die neue Cloud-Projekt
- Neu erstellte Chat-App zu Google Chat hinzufügen Projektbereichen oder Unterhaltungen und deaktivieren Sie die ursprüngliche Chat-App.
Cloud-Projekt in der zusammengeführten Organisation erstellen und APIs aktivieren
Ein neues Cloud-Projekt erstellen und APIs für die Chat-App in der zusammengeführten Google Workspace-Organisation dass Nutzer und Gruppen, denen Sie Zugriff auf die Die Chat-App kann dies ohne Fehler tun.
Cloud-Projekt erstellen
Google Cloud Console
- Öffnen Sie in der Google Cloud Console das Menü . > IAM und Verwaltung > Projekt erstellen.
-
Geben Sie im Feld Projektname einen aussagekräftigen Namen für Ihr Projekt ein.
Optional: Klicken Sie zum Bearbeiten der Projekt-ID auf Bearbeiten. Die Projekt-ID kann nicht geändert werden nachdem das Projekt erstellt wurde, wählen Sie also eine ID, die Ihren Anforderungen für die gesamte Lebensdauer des Projekt arbeiten.
- Klicken Sie im Feld Standort auf Durchsuchen, um die potenziellen Standorte für Ihr Projekt arbeiten. Klicken Sie danach auf Auswählen. <ph type="x-smartling-placeholder">
- Klicken Sie auf Erstellen. In der Google Cloud Console wird die Dashboard-Seite aufgerufen und Ihr Projekt wurde erstellt. innerhalb weniger Minuten.
gcloud-CLI
Greifen Sie in einer der folgenden Entwicklungsumgebungen auf die Google Cloud Befehlszeile („gcloud“):
-
Cloud Shell: Onlineterminal mit der gcloud CLI verwenden
aktivieren Sie Cloud Shell.
Cloud Shell aktivieren -
Lokale Shell: So verwenden Sie eine lokale Entwicklungsumgebung:
install und
Initialisieren
über die gcloud CLI.
Verwenden Sie den Befehl „gcloud projects create“, um ein Cloud-Projekt zu erstellen:
Ersetzen Sie PROJECT_ID, indem Sie die ID für das Projekt festlegen, das Sie erstellen möchten.gcloud projects create PROJECT_ID
APIs aktivieren
Für alle Chat-Apps muss die Google Chat API installiert sein aktiviert. Je nachdem, wie Ihre Chat-App aufgebaut ist, müssen möglicherweise andere APIs aktiviert werden. Wenn Sie beispielsweise die 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 Artifact Registry API und Cloud Run API Als Best Practice sollten Sie sicherstellen, migrierte Anwendung funktioniert, aktivieren Sie dieselben APIs im neuen Cloud-Projekt, sind im alten Cloud-Projekt aktiviert.
So aktivieren Sie eine API:
Google Cloud Console
- Öffnen Sie in der Google Cloud Console das 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
Chat API konfigurieren
In Ihrem neuen Cloud-Projekt müssen Sie die Chat API verwenden, um den Namen, die Beschreibung und das Symbol der Chat-App an. Bis konfigurieren Sie diese Details: Chat API konfigurieren
OAuth-Zustimmungsbildschirm konfigurieren
Möglicherweise müssen Sie den OAuth-Zustimmungsbildschirm für Ihr Konto Cloud-Projekt Wenn Sie zuvor OAuth 2.0 zur Autorisierung verwendet haben, verwenden Sie Autorisierungszugriffsbereiche.
- Öffnen Sie in der Google Cloud Console das Menü . > APIs und Dienste > OAuth-Zustimmungsbildschirm.
- Wählen Sie den Nutzertyp für Ihre Anwendung aus und klicken Sie auf Erstellen.
- Füllen Sie das App-Registrierungsformular aus und klicken Sie dann auf Speichern und fortfahren.
Wenn Sie eine App zur Verwendung außerhalb von Google Workspace erstellen Organisation auf Bereiche hinzufügen oder entfernen. Wir empfehlen die folgenden Best Practices, Bereiche auswählen:
- Wählen Sie die Bereiche aus, die die für Ihre Anwendung erforderliche Mindestzugriffsebene bieten. Eine Liste mit verfügbaren Bereichen, siehe OAuth 2.0-Bereiche für Google APIs.
- Überprüfen Sie die Bereiche, die in den drei Abschnitten aufgeführt sind: nicht vertraulich vertraulichen und eingeschränkten Bereichen. Für alle Bereiche, die in der „Ihre vertraulichen Bereiche“ oder „Meine eingeschränkten Bereiche“ sollten Sie versuchen, alternative, nicht sensible Bereiche, um unnötige zusätzliche Überprüfungen zu vermeiden.
- Für einige Umfänge sind zusätzliche Überprüfungen durch Google erforderlich. Nur für verwendete Apps intern von Ihrer Google Workspace-Organisation stammt, werden die Bereiche nicht für den Zustimmungsbildschirm und für die Verwendung von eingeschränkten oder vertraulichen Bereichen von Google überprüft werden. Weitere Informationen finden Sie unter Bereichskategorien:
- Nach Auswahl der erforderlichen Bereiche angezeigt wird, klicken Sie auf Speichern und fortfahren.
- Wenn Sie als Nutzertyp Extern ausgewählt haben, fügen Sie Testnutzer hinzu:
<ph type="x-smartling-placeholder">
- </ph>
- Klicken Sie unter Testnutzer auf Nutzer hinzufügen.
- Geben Sie Ihre E-Mail-Adresse und weitere autorisierte Testnutzer ein und klicken Sie dann auf Speichern und fortfahren.
- Überprüfen Sie Ihre App-Registrierungsübersicht. Wenn Sie Änderungen vornehmen möchten, klicken Sie auf Bearbeiten. Wenn die App mit der Registrierung in Ordnung ist, klicken Sie auf Zurück zum Dashboard.
Chat-App noch einmal im neuen Cloud-Projekt bereitstellen
Je nachdem, ob Ihre Chat-App mit Apps Script, AppSheet oder eine andere Art von Verbindung, z. B. Wenn Sie Python oder Java verwenden, klein. In beiden Fällen müssen Sie nicht den gesamten Code neu erstellen, einige Änderungen vornehmen.
Chat-App-Logik migrieren
Je nach Architektur der Chat-App, Möglicherweise müssen Sie andere Dienste in das neue Cloud-Projekt migrieren:
- Bei HTTP-Apps müssen Sie auch die restliche Anwendungslogik migrieren, wurde mit Cloud Functions, Cloud Run oder App Engine erstellt.
- Bei Chat-Apps mit natürlicher Sprache auch die Dialogflow-Agents migrieren.
- Bei Chat-Apps, die hinter einer Firewall erstellt wurden, die Pub/Sub-Themen migrieren müssen.
Interaktive Features im neuen Cloud-Projekt konfigurieren
So stellen Sie eine sprachbasierte Chat-App noch einmal bereit: wie Python oder Java, konfigurieren Sie die Chat-App in Ihrem eines neuen Cloud-Projekts.
Informationen zum Konfigurieren interaktiver Funktionen finden Sie unter Nutzerinteraktionen empfangen und darauf reagieren:
Apps Script Chat-App noch einmal bereitstellen
So stellen Sie die Chat-App noch einmal bereit, die mit Apps Script die Cloud-Projektnummer ändern, mit der Projektnummer verknüpft ist, zu Ihrem neuen Cloud-Projekt gehört. Kopieren Sie dann die Apps Script-Bereitstellungs-ID und fügen Sie sie in den Konfigurationsseite der Chat-App in der Google Cloud Console
Cloud-Projektnummer kopieren
- Öffnen Sie in der Google Cloud Console das 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.
Im Apps Script-Projekt der Chat-App Klicken Sie auf Projekteinstellungen .
Klicken Sie unter Google Cloud Platform-Projekt (GCP-Projekt) auf Projekt ändern.
Fügen Sie in 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 bereitstellen
Suchen Sie in der Google Cloud Console nach „Google Chat API“. und klicken Sie auf Google Chat API und klicken Sie dann auf Verwalten.
Klicken Sie auf den Tab Konfiguration und geben Sie Folgendes ein Informationen:
- App-Name: Der Name, den Nutzer bei der Interaktion mit Ihrem Chat-App.
- Avatar-URL: eine HTTPS-URL, die auf ein quadratisches Grafikbild verweist (z. B. PNG oder JPEG), mindestens 128 x 128 Pixel groß, wird als für Ihre Chat-App.
- Beschreibung: Eine Beschreibung des Zweck der Chat-App (wird angezeigt) unter dem Namen Ihrer Chat-App ein.
Wenn Sie die interaktiven Funktionen aktivieren möchten, klicken Sie auf Interaktive Funktionen aktivieren. Ein-/Aus-Schaltfläche, über die Nutzer mit Ihren Chat-App:
Wählen Sie unter „Verbindungseinstellungen“ die Option Apps Script-Projekt aus.
Fügen Sie im Feld Deployment ID (Bereitstellungs-ID) die zuvor verwendete Bereitstellungs-ID ein. kopiert.
Den Rest der Konfiguration finden Sie in der Tabelle im Chat-App im neuen Cloud-Projekt konfigurieren
Klicken Sie auf Speichern.
AppSheet Chat-App noch einmal bereitstellen
So stellen Sie die Chat-App, die mit der Funktion erstellt wurde, noch einmal bereit: AppSheet in Ihrem neuen Cloud-Projekt Kopieren Sie die Anwendung in das neue Cloud-Projekt.
Dienstkonto aktualisieren
Wenn sich Ihre Chat-App als App authentifiziert und ein Dienstkonto aufrufen, 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 neue Organisation, Ihre muss der Administrator möglicherweise den Zugriff Chat-App. Weitere Informationen siehe So installieren Google Workspace-Administratoren Chat-Apps
Zur neuen Chat App wechseln
Nach der Migration der Chat-App zur neuen ist es an der Zeit, sie zu veröffentlichen. In Chatbereichen hinzufügen oder Direktnachrichten und entfernen Sie dann die alte damit Nutzer nur Nachrichten an die migrierten Chat-App.
<ph type="x-smartling-placeholder">Die 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 dann wählen Sie Apps und Integrationen.
Klicken Sie auf Apps hinzufügen.
Geben Sie den Namen der App ein, wählen Sie die App aus der Liste aus und klicken Sie auf Hinzufügen:
Wiederholen Sie diese Schritte für jeden Gruppenbereich oder jede Direktnachricht, die Sie hinzufügen möchten mit der Chat-App.
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 dann wählen Sie Apps und Integrationen.
Klicken Sie neben der alten, nicht migrierten Chat-App auf Weitere Optionen und klicken Sie dann auf Aus Gruppenbereich entfernen:
Wiederholen Sie diese Schritte für jeden Gruppenbereich oder jede Direktnachricht, die Sie entfernen möchten. aus der alten Chat-App.
Alte Chat App deaktivieren
Um zu verhindern, dass Nutzer die alte Google Chat App verwenden und sie zur Nutzung der neuen Chat App zu bewegen, die alte Chat-App deaktivieren und ihre Veröffentlichung im Google Workspace Marketplace aufheben.