Google Chat API – Übersicht

In diesem Abschnitt wird erläutert, wie Sie mit der Google Chat App Anrufe starten können. die Chat API, mit der Chat-Apps beispielsweise Folgendes tun können: einen Gruppenbereich zu erstellen, Personen hinzuzufügen und eine Nachricht zu posten.

Authentifizierung

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

Weitere Informationen zur Authentifizierung in Google Chat finden Sie unter Authentifizierungsübersicht

Clientbibliotheken

Die für die meisten Entwickler empfohlene Methode zum Aufrufen der Google Chat API ist mit unserer 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 die Methode Erweiterter Chat-Dienst statt eine Clientbibliothek zu installieren.

Google Chat API – Konzepte

gRPC-Dienste oder REST-Ressourcen und -Methoden Zugriff auf Chatbereiche, Mitglieder des Gruppenbereichs, Nachrichten und Nachrichten gewähren Reaktionen, Nachrichtenanhänge, Ereignisse im Gruppenbereich und Lesestatus von Nutzern.

Gruppenbereiche

Gruppenbereiche sind Orte, an denen sich Personen und Apps miteinander austauschen und Dateien teilen können. Es sind verschiedene Arten von Leerzeichen. Direktnachrichten (DNs) sind 1:1-Unterhaltungen zwischen zwei Nutzern oder einem Nutzer und einer Chat-App. Gruppe Chats sind Gespräche zwischen drei oder mehr Nutzenden und Chat-Apps. Benannte Gruppenbereiche sind dauerhafte Orte, an die Nutzer Nachrichten senden Nachrichten zu senden, Dateien zu teilen und mit anderen zusammenzuarbeiten.

Ressourcenreferenz:

Anwendungsbeispiele:

Mitglieder

Mitglieder sind Nutzer und Chat-Apps, die beigetreten sind oder sind in einen Gruppenbereich eingeladen wurden.

Ressourcenreferenz:

Anwendungsbeispiele:

Nachrichten

Zu den Mitteilungen gehören Text und Karte Mitteilungen, die in Gruppenbereichen gepostet wurden. Nachrichten können Dateien angehängt werden. Nutzer können auf Nachrichten reagieren, indem sie Emojis anhängen.

Ressourcenreferenz:

Anwendungsbeispiele:

Reaktionen

Reaktionen sind die Emojis, mit denen Nutzer auf eine Nachricht reagieren, z. B. 👍, 🚲 und Master.

Ressourcenreferenz:

Anwendungsbeispiele:

Medien und Anhänge

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

Referenz zu Medienressourcen (in RPC nicht verfügbar):

Anhänge sind Instanzen von Medien (Dateien), die an Nachrichten angehängt wurden.

Ressourcenreferenz:

Anwendungsbeispiele:

Veranstaltungen im Weltraum

Space-Ereignisse stellen Änderungen an einem Gruppenbereich oder dessen untergeordnete Ressourcen, einschließlich ihrer Mitglieder, Nachrichten und Reaktionen.

Ressourcenreferenz:

Anwendungsbeispiele:

Lesestatus des Nutzers

Lesestatus von Nutzern sind Singleton-Ressourcen, die Details zu einem Die letzte gelesene Nachricht eines bestimmten Nutzers in einem Google Chat-Bereich oder eine Nachricht Diskussions-Thread.

Ressourcenreferenz für den Lesestatus des Gruppenbereichs:

Ressourcenreferenz zum Thread-Lesestatus:

Anwendungsbeispiele:

Chat-Apps können nicht nur die Chat API aufrufen, sondern auch: