Entwickeln mit Google Chat

Auf dieser Seite finden Sie eine Übersicht über die Google Chat API und Google Chat-Apps.

Übersicht über die Google Chat API

Die Chat API besteht aus gRPC-Diensten oder REST-Ressourcen und -Methoden, die Zugriff auf Chat gewähren, einschließlich Gruppenbereiche, Mitglieder von Gruppenbereichen, Nachrichten, Nachrichtenreaktionen, Nachrichtenanhänge, Ereignisse in Gruppenbereichen und Lesestatus von Nutzern.

Konzepte

Im folgenden Abschnitt werden die Dienste, Ressourcen und Methoden für die Chat API definiert:

Gruppenbereiche

Gruppenbereiche sind Orte, an denen sich Nutzer und Apps unterhalten und Dateien teilen können. Es gibt verschiedene Arten von Gruppenbereichen. Direktnachrichten (DNs) sind 1:1-Unterhaltungen zwischen zwei Nutzern oder einem Nutzer und einer Chat-App. Gruppenchats sind Unterhaltungen zwischen drei oder mehr Nutzern und Chat-Apps. Benannte Gruppenbereiche sind dauerhafte Orte, an denen Nutzer Nachrichten senden, Dateien teilen und zusammenarbeiten.

Ressourcenreferenz:

Beispiele zur Verwendung:

Mitglieder

Mitglieder sind Nutzer und Chat-Apps, die einem Gruppenbereich beigetreten sind oder dazu eingeladen wurden.

Ressourcenreferenz:

Beispiele zur Verwendung:

Nachrichten

Nachrichten umfassen Text- und Kartenkommunikation , die in Gruppenbereichen gepostet werden. Nachrichten können Dateianhänge enthalten. Nutzer können auf Nachrichten reagieren, indem sie Emojis anhängen.

Ressourcenreferenz:

Beispiele zur Verwendung:

Reaktionen

Reaktionen sind die Emojis, die Nutzer verwenden, um auf eine Nachricht zu reagieren, z. B. 👍, 🚲 und 🌞.

Ressourcenreferenz:

Beispiele zur Verwendung:

Benutzerdefinierte Emojis

Benutzerdefinierte Emojis sind Emojis, die in Google Chat innerhalb der Organisation erstellt und geteilt werden. Benutzerdefinierte Emojis können im Inhalt einer Nachricht enthalten sein oder verwendet werden, um auf eine Nachricht zu reagieren.

Ressourcenreferenz:

Beispiele zur Verwendung:

Abschnitte

Abschnitte ermöglichen es Nutzern, ihre Unterhaltungen zu gruppieren und die Liste der Gruppenbereiche anzupassen, die im Navigationsbereich von Google Chat angezeigt werden. Es gibt vordefinierte Systemabschnitte und benutzerdefinierte Abschnitte.

Ressourcenreferenz:

Beispiele zur Verwendung:

Medien und Anhänge

Medien sind Dateien, die in Google Chat hochgeladen wurden, z. B. Bilder, Videos und Dokumente.

Referenz zur Medienressource (in RPC nicht verfügbar):

Anhänge sind Medieninstanzen (Dateien), die an Nachrichten angehängt sind.

Ressourcenreferenz:

Beispiele zur Verwendung:

Ereignisse in Gruppenbereichen

Ereignisse in Gruppenbereichen stellen Änderungen an einem Gruppenbereich oder seinen untergeordneten Ressourcen dar, einschließlich seiner Mitglieder, Nachrichten und Reaktionen.

Ressourcenreferenz:

Beispiele zur Verwendung:

Lesestatus von Nutzern

Lesestatus von Nutzern sind Singleton-Ressourcen, die Details zur zuletzt gelesenen Nachricht eines bestimmten Nutzers in einem Google Chat-Gruppenbereich oder einem Nachrichtenthread darstellen.

Referenz zur Ressource „Lesestatus des Gruppenbereichs“:

Referenz zur Ressource „Lesestatus des Threads“:

Beispiele zur Verwendung:

Benachrichtigungseinstellungen für Gruppenbereiche von Nutzern

Benachrichtigungseinstellungen für Gruppenbereiche von Nutzern sind Singleton-Ressourcen, die die Benachrichtigungseinstellungen eines bestimmten Nutzers in einem Google Chat-Gruppenbereich darstellen.

Ressourcenreferenz:

Authentifizierung

Für den Aufruf der Chat API ist eine Authentifizierung erforderlich. Für jede Chat API-Methode ist entweder eine Nutzerauthentifizierung (um Aktionen auszuführen oder auf Daten im Namen eines Nutzers zuzugreifen) oder eine App-Authentifizierung (um Aktionen auszuführen oder auf Daten als Chat-App zuzugreifen) erforderlich. Einige Methoden unterstützen sowohl die Nutzer- als auch die App-Authentifizierung.

Weitere Informationen zur Authentifizierung in Chat finden Sie unter Authentifizierung.

Clientbibliotheken

Die empfohlene Methode für die meisten Entwickler zum Aufrufen der Google Chat API sind unsere offiziell unterstützten Cloud-Clientbibliotheken für Ihre bevorzugte Sprache, z. B. Python, Java oder Node.js.

Wenn Sie mit Google Apps Script programmieren, verwenden Sie stattdessen den erweiterten Chat-Dienst , anstatt eine Clientbibliothek zu installieren.

Chat-Apps erstellen

Mit der Chat API können Sie Google Chat-Apps erstellen, mit denen Sie Ihre Dienste und Ressourcen direkt in Google Chat einbinden können. Sie können Chat-Apps für folgende Zwecke erstellen:

  • Informationen basierend auf strukturierten oder Freitextabfragen abrufen, die vom Nutzer eingegeben wurden.
  • Vorfallberichte oder andere Artefakte mit den vom Nutzer bereitgestellten Informationen erstellen.
  • Zusammenarbeit im Team verbessern, z. B. durch Bereitstellung eines „Teamgedächtnisses“ oder Planung von Ressourcen.

Sie können Ihre Chat-App mit verschiedenen Architekturstilen entwerfen, darunter:

  • Interaktive Apps: Auf Nutzerinteraktionen wie @-Erwähnungen oder Slash Befehle reagieren und Informationen präsentieren oder Nutzer mit Karten und Dialogfeldern durch einen Workflow führen.
  • Befehlszeilen-Apps oder Webhooks: Proaktive Nachrichten wie Alarme oder Benachrichtigungen von einem anderen System in einen Gruppenbereich senden. Nutzer können nicht direkt mit dieser Art von App interagieren.
  • Ereignisgesteuerte Apps: Aktivitäten in einem Chat-Gruppenbereich abonnieren und darauf reagieren, z. B. wenn ein neues Mitglied beitritt. Als Reaktion auf ein Ereignis kann die App eine Nachricht senden oder eine andere Aktion ausführen.

Weitere Informationen zum Entwerfen Ihrer Chat-App finden Sie unter Google Chat-App-Architektur auswählen.

Möchten Sie die Google Chat API in Aktion sehen?
Auf dem Google Workspace Developers-Kanal finden Sie Videos mit Tipps, Tricks und den neuesten Funktionen.