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, ohne von einem Chat-App-Interaktionsereignis.
Authentifizierung
Für den asynchronen 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
API-Ressourcen und -Methoden
REST-Ressourcen und -Methoden gewähren asynchronen Zugriff auf Google Chat Gruppenbereiche, Mitglieder des Gruppenbereichs, Nachrichten, Reaktionen auf Nachrichten und Nachrichtenanhänge.
- 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.
Die
spaces-Ressource stellt ein Leerzeichen dar.Gruppenbereiche unterstützen die folgenden Methoden:
- Gruppenbereich erstellen, ein Ort, an dem Nutzer und Apps sich unterhalten und Dateien teilen können.
- Gruppenbereich einrichten um den Gruppenbereich zu erstellen und ihm Personen und Chat-Apps hinzuzufügen Leerzeichen.
- Gruppenbereich anfordern um Details zu einem Gruppenbereich aufzurufen.
- Gruppenbereiche auflisten um eine paginierte, filterbare Liste von Gruppenbereichen zu sehen.
- Gruppenbereiche aktualisieren zum Ändern von Attributen eines Gruppenbereichs, z. B. den für den Nutzer sichtbaren Anzeigenamen, Beschreibung und Richtlinien.
- Gruppenbereiche löschen wenn sie nicht mehr benötigt werden.
- Direktnachrichten suchen , um eine DN zwischen zwei Nutzern oder eine DN zwischen einem Nutzer und dem aufrufenden Nutzer zurückzugeben. Chat-Apps.
- Mitglieder
Mitglieder sind Nutzer und Chat-Apps, die beigetreten sind oder sind in einen Gruppenbereich eingeladen wurden.
Die
spaces.members-Ressource steht für ein Mitglied.Mitglieder unterstützen die folgenden Methoden:
- Mitgliedschaft erstellen , um einem Gruppenbereich einen Nutzer oder eine App hinzuzufügen.
- Abo abschließen um Details zu einer Mitgliedschaft aufzurufen.
- Mitgliedschaften auflisten um eine paginierte, filterbare Liste der Mitgliedschaften in einem Gruppenbereich aufzurufen.
- Mitgliedschaft aktualisieren Attribute einer Mitgliedschaft ändern, z. B. zum Ändern eines Mitglieds eines Gruppenbereichs oder den Administrator eines Gruppenbereichs zu einem Mitglied ändern.
- Mitgliedschaft löschen , um einen Nutzer oder eine App aus einem Gruppenbereich zu entfernen.
- 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.
Die
spaces.messages-Ressource steht für eine Nachricht.In Messages werden die folgenden Methoden unterstützt:
- Nachricht erstellen um eine Textnachricht zu posten oder Kartennachricht. Sie können auch eine Unterhaltung starten oder darauf antworten.
- Nachricht erhalten um Details zu einer Nachricht zu erhalten, z. B. wann sie gesendet wurde oder was sie enthält.
- Nachrichten auflisten um eine paginierte, filterbare Liste von Nachrichten in einem Gruppenbereich aufzurufen.
- Nachrichten aktualisieren Nachrichtenattribute ändern, z. B. was darin steht. Sie können auch Text anhängen, in ein Kartennachricht, oder eine Karte zu einem SMS.
- Nachrichten löschen wenn sie nicht mehr benötigt werden.
- Reaktionen
Reaktionen sind die Emojis, mit denen Nutzer auf eine Nachricht reagieren, z. B. 👍, 🚲 und Master.
Die
spaces.messages.reactions-Ressource für eine Reaktion.Für Reaktionen werden die folgenden Methoden unterstützt:
- Reaktion erstellen , um einer Nachricht ein Emoji hinzuzufügen.
- Reaktionen auflisten um eine paginierte, filterbare Liste mit Reaktionen auf eine Nachricht zu sehen.
- Reaktionen löschen um ein Emoji aus der Nachricht zu entfernen.
- Medien und Anhänge
Medien sind Dateien, die in Google Chat hochgeladen werden, z. B. Bilder, Videos und Dokumente.
Die
media-Ressource steht für Medien, die an Nachrichten angehängt sind.Anhänge sind Instanzen von Medien (Dateien), die an Nachrichten angehängt wurden.
Die
spaces.messages.attachments-Ressource steht für einen Anhang. Ein Anhang enthält die Medien und die zugehörigen Metadaten, die an eine Nachricht angehängt sind.Medien und Anhänge unterstützen die folgenden Methoden:
- Medien als Anhang hochladen , um Medien in Google Chat hochzuladen und sie dann an eine Nachricht anzuhängen.
- Medien als Anhang herunterladen , um Medien aus Google Chat als Binärdatei herunterzuladen.
- Anhänge abrufen um Metadaten zu einem Nachrichtenanhang abzurufen.
- Veranstaltungen im Weltraum
Space-Ereignisse stellen Änderungen an einem Gruppenbereich oder dessen untergeordnete Ressourcen, einschließlich ihrer Mitglieder, Nachrichten und Reaktionen.
spaces.spaceEvent-Ressource ein Weltraumereignis darstellt.Ereignisse in Gruppenbereichen unterstützen die folgenden Methoden:
- Hol dir ein Space-Event um Details zu einem Ereignis abzurufen, das in einem Gruppenbereich aufgetreten ist.
- Space-Ereignisse auflisten um eine Liste der Ereignisse in einem Gruppenbereich abzurufen.
- 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.
users.spaces-Ressource stellt den Lesestatus eines Nutzers in einem Gruppenbereich dar.users.spaces.threads-Ressource stellt den Lesestatus eines Nutzers in einem Nachrichten-Thread dar.Lesestatus von Nutzern unterstützen die folgenden Methoden:
- Lesestatus des Gruppenbereichs abrufen um Details zum Lesestatus eines Nutzers innerhalb eines Gruppenbereichs zurückzugeben.
- Lesestatus des Gruppenbereichs aktualisieren um den Lesestatus eines Nutzers in einem Gruppenbereich zu aktualisieren.
- Thread-Lesestatus abrufen um Details zum Lesestatus eines Nutzers innerhalb eines Threads zurückzugeben.