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 Nutzerauthentifizierung als auch die App-Authentifizierung.
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:
Weitere Informationen
- Beispiele für die Google Chat App zum Einstieg in die Chat API.
Chat-Apps können nicht nur die Chat API aufrufen, sondern auch:
- Chat-App-Interaktionsereignisse empfangen und darauf reagieren wie Nachrichten, die an die Google Chat App gesendet werden, in Echtzeit.
- Google Chat-Ereignisse abonnieren handeln oder reagieren, wenn bestimmte oder Änderungen in Google Chat, z. B. neue Nachrichten und Mitgliedschaftsänderungen.