In diesem Abschnitt wird erläutert, wie eine Google Chat-App die Chat API aufrufen kann. So können Chat-Apps beispielsweise Gruppenbereiche erstellen, Personen hinzufügen und Nachrichten posten.
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 im Namen eines Nutzers auf Daten zuzugreifen) oder eine App-Authentifizierung (um Aktionen auszuführen oder als Chat-App auf Daten zuzugreifen) erforderlich. Einige Methoden unterstützen sowohl die Nutzerauthentifizierung als auch die App-Authentifizierung.
Weitere Informationen zur Authentifizierung in Google Chat finden Sie unter Authentifizierung.
Clientbibliotheken
Die meisten Entwickler sollten die Google Chat API mit unseren offiziell unterstützten Cloud-Clientbibliotheken für ihre bevorzugte Sprache wie Python, Java oder Node.js aufrufen.
Wenn Sie mit Google Apps Script programmieren, verwenden Sie den erweiterten Chatdienst, anstatt eine Clientbibliothek zu installieren.
Konzepte der Google Chat API
gRPC-Dienste oder REST-Ressourcen und ‑Methoden gewähren Zugriff auf Google Chat-Gruppenbereiche, Gruppenbereichsmitglieder, Nachrichten, Nachrichtenreaktionen, Nachrichtenanhänge, Gruppenbereichsereignisse und Lesestatus von Nutzern.
- Gruppenbereiche
Gruppenbereiche sind Orte, an denen Personen und Apps miteinander kommunizieren und Dateien teilen können. Es gibt verschiedene Arten von Gruppenbereichen. Direktnachrichten sind Unterhaltungen zwischen zwei Nutzern oder einem Nutzer und einer Chat-App. Gruppenchats sind Unterhaltungen zwischen drei oder mehr Nutzern und Chat-Apps. Namensgruppenbereiche sind persistente Orte, an denen Nutzer Nachrichten senden, Dateien teilen und zusammenarbeiten können.
Ressourcenreferenz:
Beispiele zur Verwendung:
- Mitglieder
Mitglieder sind Nutzer und Chat-Apps, die einem Gruppenbereich beigetreten sind oder eingeladen wurden.
Ressourcenreferenz:
Beispiele zur Verwendung:
- Nachrichten
Nachrichten umfassen Text und Karten, die in Gruppenbereichen gepostet wurden. Nachrichten können Dateien angehängt haben. Nutzer können auf Nachrichten reagieren, indem sie ihnen Emojis hinzufügen.
Ressourcenreferenz:
Beispiele zur Verwendung:
- Reaktionen
Reaktionen sind Emojis, mit denen Nutzer auf eine Nachricht reagieren, z. B. 👍, 🚲 und 🌞.
Ressourcenreferenz:
Beispiele zur Verwendung:
- Benutzerdefinierte Emojis (Entwicklervorschau)
Benutzerdefinierte Emojis sind benutzerdefinierte Emojis, die in Google Chat innerhalb der Organisation erstellt und freigegeben wurden. Benutzerdefinierte Emojis können in den Inhalt einer Nachricht eingefügt oder verwendet werden, um auf eine Nachricht zu reagieren.
Ressourcenreferenz:
- Medien und Anhänge
Medien sind Dateien, die in Google Chat hochgeladen wurden, z. B. Bilder, Videos und Dokumente.
Referenz auf Medienressource (nicht in RPC verfügbar):
Anhänge sind Medien (Dateien), die an Nachrichten angehängt sind.
Ressourcenreferenz:
Beispiele zur Verwendung:
- Weltraumereignisse
Gruppenbereichsereignisse spiegeln Änderungen an einem Gruppenbereich oder seinen untergeordneten Ressourcen wider, 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 Nachrichten-Thread enthalten.
Ressourcenreferenz für den Lesestatus des Gruppenbereichs:
Referenz zur Ressource „Thread-Lesestatus“:
Beispiele zur Verwendung:
- Benachrichtigungseinstellungen für den Nutzerbereich (Vorabversion für Entwickler)
Benachrichtigungseinstellungen für Nutzergruppenbereiche sind Singleton-Ressourcen, die die Benachrichtigungseinstellungen für einen bestimmten Nutzer in einem Google Chat-Gruppenbereich darstellen.
Ressourcenreferenz:
Weitere Informationen
- In dieser Demo erfahren Sie, wie Sie die Chat API verwenden.
Neben dem Aufrufen der Chat API können Chat-Apps auch:
- Ereignisse für Chat-App-Interaktionen wie Nachrichten, die an die Google Chat App gesendet werden, in Echtzeit empfangen und beantworten.
- Abonnieren Sie Google Chat-Ereignisse, um Maßnahmen zu ergreifen oder zu reagieren, wenn bestimmte Aktivitäten oder Änderungen in Google Chat auftreten, z. B. neue Nachrichten und Änderungen an der Gruppenmitgliedschaft.