Auf dieser Seite erhalten Sie einen Überblick über die Verwendung der Google Chat API und der zugehörigen Referenzdokumentation.
Die Google Chat API bietet sowohl gRPC- als auch REST-Schnittstellen sowie Clientbibliotheken, die beide unterstützen. Falls die bereitgestellten Clientbibliotheken nicht Ihren Anforderungen entsprechen, können Sie eigene Clientbibliotheken mit der gRPC- oder REST-Schnittstelle schreiben.
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.
Typ-, Methoden- und Feldnamen
Je nachdem, ob Sie Clientbibliotheken, gRPC oder REST verwenden, variieren die Typen, Methoden und Feldnamen für die Google Chat API etwas:
- Cloud-Clientbibliotheken sind nach gRPC-Diensten und ihren Methoden angeordnet. Google API-Clientbibliotheken sind als Dienste angeordnet, die Objekte oder Klassen enthalten, die den REST-Ressourcen entsprechen, die auch entsprechende Methoden enthalten.
- gRPC ist nach Diensten und ihren Methoden angeordnet.
- REST ist nach Ressourcenhierarchien und ihren Methoden angeordnet.
- gRPC-Feldnamen nutzen die Snake-Case-Schreibweise.
- Die Namen der REST-Felder haben eine Camel-Case-Schreibweise, auch wenn der API-Dienst entweder eine Camel- oder Snake-Case-Schreibweise akzeptiert.
- In den Namen der Clientbibliotheken wird entweder Groß-/Kleinschreibung, die Camel-Case- oder Snake-Case-Schreibweise verwendet, je nachdem, welcher Name für die Sprache idiomatisch ist.
Log-Puffer
Unabhängig davon, ob Sie Clientbibliotheken, REST oder gRPC verwenden, wird der zugrunde liegende Dienst mit Protokollpuffern definiert. Insbesondere verwendet der Dienst proto3.
Beim Aufrufen der API erfordern einige Anfrage- oder Antwortfelder ein grundlegendes Verständnis der bekannten Typen des Protokollpuffers.
Außerdem kann beim Aufruf der REST API das Verhalten des Standardwerts für Protokoll-Buffers zu fehlenden Feldern in einer JSON-Antwort führen. Diese Felder sind auf den Standardwert festgelegt und werden daher nicht in die Antwort eingefügt.
API-Versionen
Folgende API-Versionen sind verfügbar:
- v1: Stabil.
Entwicklervorschau
In der Dokumentation finden Sie möglicherweise API-Methoden oder ‑Felder, die nur über das Entwickler-Vorabprogramm verfügbar sind. Wenn Sie die neuesten Vorschaufunktionen testen, in der Vorschau ansehen und Feedback dazu geben möchten, nehmen Sie am Vorschauprogramm für Entwickler teil.