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 die Chat-Funktionen 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 für Nutzer 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 Schnellbefehle reagieren.
- Sie können auf Slash-Befehle reagieren.
- Öffnen Sie Dialogfelder, um Nutzern bei mehrstufigen Prozessen wie dem Ausfüllen von Formulardaten zu helfen.
- Fügen Sie Karten mit hilfreichen Informationen an, um Links in Nachrichten in der Vorschau anzuzeigen. So können Nutzer direkt über die Unterhaltung Aktionen ausführen.
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 Chat-Oberflächen erstellen.
Beschränkungen und bekannte Probleme
Die folgenden Chat- und Add-on-Funktionen sind nicht verfügbar:
- Die Chat-App-Architekturen Dialogflow, Pub/Sub und AppSheet sind nicht verfügbar. Stattdessen müssen Sie die Chat-App mit Apps Script oder einem HTTP-Dienst erstellen.
- 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 Dialoge ö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 bestehendes 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 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.