Auf dieser Seite finden Sie einen Überblick darüber, wie Sie Google Workspace-Add‑ons erstellen, die Google Chat erweitern.
Google Workspace-Add-ons, die Chat erweitern, können Nutzern bei Folgendem helfen:
- Sie können sich Links aus Chat-Nachrichten 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 Chat
In Chat werden Add‑ons für Nutzer als Google Chat-Apps angezeigt. Chat-Apps können folgende Aktionen ausführen, um mit Nutzern zu interagieren:
- Nachrichten senden, die Text, Karten und interaktive UI-Elemente enthalten.
- Auf Schnellbefehle reagieren.
- Auf Slash-Befehle reagieren
- Dialogfelder öffnen, um Nutzern bei mehrstufigen Prozessen wie dem Ausfüllen von Formulardaten zu helfen.
- Vorschaulinks in Nachrichten, indem Sie Karten mit hilfreichen Informationen anhängen, die es Nutzern ermöglichen, direkt über die Unterhaltung Maßnahmen zu ergreifen.
Jetzt starten
Wenn Sie Google Workspace-Add-ons erstellen möchten, die in Chat funktionieren, finden Sie in der folgenden Dokumentation weitere Informationen:
- In einer Kurzanleitung erfahren Sie, wie Sie eine einfache Chat-App mit Google Apps Script oder einem HTTP-Dienst erstellen.
- Chat-App konfigurieren und interaktive Funktionen über die Chat API konfigurieren.
- Chat-Oberflächen erstellen mit Add-on-Triggern, ‑Aktionen und ‑Ereignisobjekten
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.
- Card Service von Apps Script. Wenn Sie Chat-Aktionen verwenden und Karten erstellen möchten, geben Sie stattdessen JSON-Objekte zurück. Beispiele finden Sie unter Interaktive Dialogfelder öffnen und Links in der Vorschau ansehen.
- Benutzerdefinierte Autorisierungskarten Damit Ihr Dienst von Google Chat authentifiziert und autorisiert werden kann, muss die Chat-App eine Karte für die grundlegende Autorisierung zurückgeben.
- Add-on-Startseiten in der Google Chat-Seitenleiste. Wenn Sie einen Startseitentrigger für Ihr Add-on konfiguriert haben, wird die Startseite nur in der Seitenleiste der anderen Google Workspace-Anwendungen angezeigt, die durch Ihr Add-on erweitert werden.
- Startseiten von Chat-Apps, die auf dem Tab Startseite von 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:
- Die Installationseinstellungen für den Google Workspace Marketplace müssen es sowohl Einzelpersonen als auch Google Workspace-Administratoren erlauben, das Add-on zu installieren.
- Alle allgemeinen Konfigurationseinstellungen im Manifest des Add-ons (
addons.common) werden in Chat ignoriert. Damit das Add-on in 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 Chat bereitstellen und testen möchten, müssen Sie die Sichtbarkeit-Einstellung 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 Chat finden Sie in der Chat API-Dokumentation unter Interaktive Funktionen für Google Chat-Apps testen.
- Wenn Ihr Add‑on im Google Workspace Marketplace veröffentlicht wird, können Sie keinen Entwurf von Änderungen an den Konfigurationseinstellungen für die Google Chat API speichern. Wenn Sie die Konfigurationseinstellungen der Chat API aktualisieren, ist die aktualisierte Chat-App sofort für alle vorhandenen Nutzer verfügbar. Wenn Sie Ihren Marketplace-Eintrag aktualisieren möchten, können Sie einen Entwurf erstellen, bevor Sie Änderungen einreichen.