Google Chat API – Übersicht

In den Leitfäden in diesem Abschnitt wird erläutert, wie eine Google Chat-App die Chat API aufrufen kann. Damit können Chat-Apps beispielsweise einen Gruppenbereich erstellen, Personen hinzufügen und eine Nachricht posten, ohne von einem Interaktionsereignis der Chat-App dazu aufgefordert zu werden.

Authentifizierung

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

Weitere Informationen zur Authentifizierung in Chat finden Sie unter Authentifizierung.

API-Ressourcen und -Methoden

REST-Ressourcen und -Methoden gewähren asynchronen Zugriff auf Chatbereiche, Mitglieder von Gruppenbereichen, Nachrichten, Nachrichtenreaktionen und Nachrichtenanhänge.

Gruppenbereiche

In Gruppenbereichen können sich Nutzer und Apps unterhalten und Dateien teilen. Es gibt verschiedene Arten von Gruppenbereichen. Direktnachrichten (DN) 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 persistente Orte, an denen Personen Nachrichten senden, Dateien teilen und zusammenarbeiten.

Die Ressource spaces stellt einen Bereich dar.

Gruppenbereiche unterstützen die folgenden Methoden:

Mitglieder

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

Die Ressource spaces.members stellt ein Mitglied dar.

Mitglieder unterstützen die folgenden Methoden:

Nachrichten

Nachrichten enthalten Textmitteilungen und Karten, die in Gruppenbereichen gepostet werden. An Nachrichten können Dateien angehängt werden. Personen können auf Nachrichten reagieren, indem sie ihnen Emojis hinzufügen.

Die Ressource spaces.messages stellt eine Nachricht dar.

Messages unterstützt die folgenden Methoden:

Reaktionen

Reaktionen stehen für die Emojis, mit denen Nutzer auf eine Nachricht reagieren, z. B. 👍, 🚲 und Ю.

Die Ressource spaces.messages.reactions stellt eine Reaktion dar.

Für Reaktionen werden die folgenden Methoden unterstützt:

Medien und Anhänge

Medien stellt eine in Google Chat hochgeladene Datei dar, z. B. Bilder, Videos und Dokumente.

Die Ressource media stellt Medien dar, die an Nachrichten angehängt sind.

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

Die Ressource spaces.messages.attachments stellt einen Anhang dar. Ein Anhang enthält die an eine Nachricht angehängten Medien und zugehörigen Metadaten.

Bei Medien und Anhängen werden folgende Methoden unterstützt:

Lesestatus der Nutzer (Entwicklervorschau)

Lesestatus des Nutzers sind Singleton-Ressourcen, die Details zur zuletzt gelesenen Nachricht eines bestimmten Nutzers in einem Google Chat-Bereich oder einem Nachrichten-Thread darstellen.

Die Ressource users.spaces stellt den Lesestatus eines Nutzers in einem Bereich dar.

Die Ressource users.spaces.threads stellt den Lesestatus eines Nutzers in einem Nachrichten-Thread dar.

Für den Nutzer-Lesestatus werden die folgenden Methoden unterstützt:

Discovery-Dokument suchen

Das Discovery-Dokument für diese API befindet sich unter der folgenden URL: