Google Chat API

Mit der Google Chat API können Sie Chat-Apps erstellen, um Ihre Dienste in Google Chat einzubinden und Chatressourcen wie Gruppenbereiche, Mitglieder und Nachrichten zu verwalten.

Dienst: chat.googleapis.com

Zum Aufrufen dieses Dienstes empfehlen wir die Verwendung der von Google bereitgestellten Clientbibliotheken. Wenn Ihre Anwendung Ihre eigenen Bibliotheken zum Aufrufen dieses Dienstes verwenden muss, verwenden Sie bei den API-Anfragen die folgenden Informationen.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente haben. Der Dienst bietet das folgende Discovery-Dokument:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://chat.googleapis.com

REST-Ressource: v1.media

Methoden
download GET /v1/media/{resourceName=**}
Lädt Medien herunter.
upload POST /v1/{parent=spaces/*}/attachments:upload
POST /upload/v1/{parent=spaces/*}/attachments:upload
Lädt einen Anhang hoch.

REST-Ressource: v1.spaces

Methoden
completeImport POST /v1/{name=spaces/*}:completeImport
Schließt den Importvorgang für den angegebenen Gruppenbereich ab und macht ihn für Nutzer sichtbar.
create POST /v1/spaces
Ein Gruppenbereich ohne Mitglieder wird erstellt.
delete DELETE /v1/{name=spaces/*}
Löscht einen benannten Gruppenbereich.
findDirectMessage GET /v1/spaces:findDirectMessage
Gibt die vorhandene Direktnachricht an den angegebenen Nutzer zurück
get GET /v1/{name=spaces/*}
Gibt Details zu einem Gruppenbereich zurück.
list GET /v1/spaces
Listet Gruppenbereiche auf, in denen der Aufrufer Mitglied ist.
patch PATCH /v1/{space.name=spaces/*}
Aktualisiert einen Gruppenbereich.
search GET /v1/spaces:search
setup POST /v1/spaces:setup
Erstellt einen Gruppenbereich und fügt ihm angegebene Nutzer hinzu.

REST-Ressource: v1.spaces.members

Methoden
create POST /v1/{parent=spaces/*}/members
Es wird eine Mitgliedschaft für die anrufende Chat-App, einen Nutzer oder eine Google-Gruppe erstellt.
delete DELETE /v1/{name=spaces/*/members/*}
Löscht eine Mitgliedschaft.
get GET /v1/{name=spaces/*/members/*}
Gibt Details zu einer Mitgliedschaft zurück.
list GET /v1/{parent=spaces/*}/members
Listet Mitgliedschaften in einem Gruppenbereich auf.
patch PATCH /v1/{membership.name=spaces/*/members/*}
Aktualisiert eine Mitgliedschaft.

REST-Ressource: v1.spaces.messages

Methoden
create POST /v1/{parent=spaces/*}/messages
Eine Nachricht in einem Google Chat-Bereich erstellen.
delete DELETE /v1/{name=spaces/*/messages/*}
Löscht eine Nachricht.
get GET /v1/{name=spaces/*/messages/*}
Gibt Details zu einer Nachricht zurück.
list GET /v1/{parent=spaces/*}/messages
Listet Nachrichten in einem Gruppenbereich auf, in dem der Anrufer Mitglied ist, einschließlich Nachrichten von blockierten Mitgliedern und Gruppenbereichen.
patch PATCH /v1/{message.name=spaces/*/messages/*}
Aktualisiert eine Nachricht.
update PUT /v1/{message.name=spaces/*/messages/*}
Aktualisiert eine Nachricht.

REST-Ressource: v1.spaces.messages.attachments

Methoden
get GET /v1/{name=spaces/*/messages/*/attachments/*}
Ruft die Metadaten eines Nachrichtenanhangs ab.

REST-Ressource: v1.spaces.messages.reactions

Methoden
create POST /v1/{parent=spaces/*/messages/*}/reactions
Erstellt eine Reaktion und fügt sie einer Nachricht hinzu.
delete DELETE /v1/{name=spaces/*/messages/*/reactions/*}
Löscht eine Reaktion auf eine Nachricht.
list GET /v1/{parent=spaces/*/messages/*}/reactions
Listet Reaktionen auf eine Nachricht auf.

REST-Ressource: v1.spaces.spaceEvents

Methoden
get GET /v1/{name=spaces/*/spaceEvents/*}
Gibt einen Termin aus einem Google Chat-Bereich zurück.
list GET /v1/{parent=spaces/*}/spaceEvents
Listet Ereignisse aus einem Google Chat-Bereich auf.

REST-Ressource: v1.users.spaces

Methoden
getSpaceReadState GET /v1/{name=users/*/spaces/*/spaceReadState}
Gibt Details zum Lesestatus eines Nutzers innerhalb eines Gruppenbereichs zurück. Diese Informationen werden verwendet, um gelesene und ungelesene Nachrichten zu identifizieren.
updateSpaceReadState PATCH /v1/{spaceReadState.name=users/*/spaces/*/spaceReadState}
Aktualisiert den Lesestatus eines Nutzers in einem Gruppenbereich. Er wird verwendet, um gelesene und ungelesene Nachrichten zu identifizieren.

REST-Ressource: v1.users.spaces.threads

Methoden
getThreadReadState GET /v1/{name=users/*/spaces/*/threads/*/threadReadState}
Gibt Details zum Lesestatus eines Nutzers innerhalb eines Threads zurück, um gelesene und ungelesene Nachrichten zu identifizieren.