Hast du 5 Minuten Zeit?
Helfen Sie uns, unsere Google Workspace-Dokumentation zu verbessern, indem Sie an einer kurzen Onlineumfrage teilnehmen.
|
Auf dieser Seite finden Sie einen Überblick darüber, wie Sie Google Workspace-Add‑ons erstellen, die Google Chat erweitern.
Google Workspace-Add-ons für Google Chat können Nutzer*innen bei Folgendem helfen:
- Links aus Chatnachrichten in der Vorschau ansehen und Aktionen ausführen, ohne die Unterhaltung zu verlassen.
- Aufgaben in Google Workspace-Anwendungen automatisieren oder ausführen.
- Benachrichtigungen über externe Tools oder Dienste 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.
- Links in Nachrichten in der Vorschau ansehen: Hängen Sie Karten mit hilfreichen Informationen an, damit Nutzer direkt in der Unterhaltung Aktionen ausführen können.
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 und ihre interaktiven Funktionen mit der 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 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 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 wurde, 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, steht die aktualisierte Chat-App allen vorhandenen Nutzern sofort zur Verfügung. Wenn Sie Ihren Marketplace-Eintrag aktualisieren möchten, können Sie einen Entwurf erstellen, bevor Sie Änderungen einreichen.