Auf dieser Seite finden Sie einen Überblick darüber, wie Sie Google Workspace-Add-ons erstellen, die Google Chat erweitern.
Mit Google Workspace-Add-ons, die Google Chat erweitern, können Nutzer Folgendes tun:
- Sie können sich Links aus Chatnachrichten in einer Vorschau ansehen und Aktionen ausführen, ohne die Unterhaltung zu verlassen.
- Aufgaben in Google Workspace-Anwendungen automatisieren oder ausführen
- Benachrichtigungen zu externen Tools oder Diensten erhalten.
So funktionieren Google Workspace-Add-ons in Google Chat
In Google Chat werden Add-ons Nutzern als Google Chat-Apps angezeigt. Chat-Apps können für die Interaktion mit Nutzern Folgendes tun:
- Nachrichten senden, die Text, Karten und interaktive UI-Elemente enthalten
- Sie können auf Slash-Befehle reagieren.
- Öffnen Sie Dialogfelder, um Nutzern bei mehrstufigen Prozessen wie dem Ausfüllen von Formulardaten zu helfen.
- Sie können Links in Nachrichten als Vorschau anzeigen, indem Sie Karten mit hilfreichen Informationen anhängen, über die Nutzer direkt aus der Unterhaltung heraus Aktionen ausführen können.
Jetzt starten
In der folgenden Dokumentation erfahren Sie, wie Sie Google Workspace-Add-ons erstellen, die in Google Chat funktionieren:
- In der Kurzanleitung erfahren Sie, wie Sie mit Google Apps Script oder einem HTTP-Dienst eine einfache Chat-App erstellen.
- Konfigurieren Sie eine Chat-App und ihre interaktiven Funktionen mit der Chat API.
- Hier erfahren Sie, wie Sie mit Add-on-Triggern, ‑Aktionen und ‑Ereignisobjekten Chatoberflächen erstellen können.
Beschränkungen und bekannte Probleme
Die folgenden Chat- und Add-on-Funktionen sind nicht verfügbar:
- Kartendienst von Apps Script Wenn Sie Chataktionen verwenden und Karten erstellen möchten, geben Sie stattdessen JSON-Objekte zurück. Beispiele finden Sie unter Interaktive Dialogfelder öffnen und Vorschaulinks.
- Benutzerdefinierte Autorisierungskarten Damit Ihr Dienst in Google Chat authentifiziert und autorisiert werden kann, muss die Chat-App eine grundlegende Autorisierungskarte zurückgeben.
- Add-on-Startseiten in der Chat-Seitenleiste Wenn Sie für Ihr Add-on einen Startseitentrigger konfiguriert haben, wird die Startseite nur in der Seitenleiste der anderen Google Workspace-Anwendungen angezeigt, die Ihr Add-on erweitert.
- Startseiten von Chat-Apps, die auf dem Tab Startseite in Direktnachrichten mit der Chat-App angezeigt werden.
Wenn Sie ein vorhandenes Google Workspace-Add-on aktualisieren, beachten Sie die folgenden Konfigurationsanforderungen für Chat-Apps:
- In den Installationseinstellungen für den Google Workspace Marketplace muss sowohl Einzelpersonen als auch Google Workspace-Administratoren erlaubt sein, das Add-on zu installieren.
- Alle gängigen Konfigurationseinstellungen im manifest (
addons.common) des Add-ons werden in Google Chat ignoriert. Damit das Add-on in Google Chat funktioniert, müssen Sie die Chat API aktivieren und konfigurieren. Eine Anleitung finden Sie unter Google Chat-App konfigurieren. - Wenn Sie mit einem HTTP-Dienst arbeiten, müssen Sie die Google Workspace Add-ons API aktivieren. Die REST-Ressourcen
deploymentundprojectgelten nur für Add-on-Bereitstellungen in anderen Google Workspace-Anwendungen. - Wenn Sie ein Add-on in Google Chat bereitstellen und testen möchten, müssen Sie die Einstellung Sichtbarkeit der Chat API verwenden. Alle Sichtbarkeits- oder Testeinstellungen, die Sie im Google Workspace Marketplace SDK konfiguriert haben, werden ignoriert. Informationen zum Bereitstellen einer Testversion des Add-ons in Google Chat finden Sie in der Chat API-Dokumentation unter Interaktive Funktionen für Google Chat-Apps testen.
- Wenn Ihre Add-ons im Google Workspace Marketplace veröffentlicht sind, können Sie keine Änderungen an den Konfigurationseinstellungen der Google Chat API als Entwurf speichern. Wenn Sie die Konfigurationseinstellungen der Chat API aktualisieren, ist die aktualisierte Chat-App sofort für alle bestehenden Nutzer verfügbar. Wenn Sie Ihren Marktplatzeintrag aktualisieren möchten, können Sie einen Entwurf erstellen, bevor Sie Änderungen einreichen.