Auf dieser Seite finden Sie eine Übersicht über die Verwendung der Google Chat API und der zugehörigen Referenzdokumentation.
Die Google Chat API hat sowohl gRPC- als auch REST-Schnittstellen und Clientbibliotheken, die beide unterstützen. Wenn die bereitgestellten Clientbibliotheken Ihren Anforderungen nicht entsprechen, können Sie optional eigene Clientbibliotheken schreiben, die die gRPC- oder REST-Schnittstelle verwenden.
Clientbibliotheken
Die empfohlene Methode für die meisten Entwickler, die Google Chat API aufzurufen, sind unsere offiziell unterstützten Cloud-Clientbibliotheken für Ihre bevorzugte Sprache wie Python, Java oder Node.js.
Wenn Sie mit Google Apps Script programmieren, verwenden Sie den erweiterten Chat-Dienst, 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:
- Cloud-Clientbibliotheken sind nach gRPC-Diensten und ihren Methoden angeordnet. Google API-Clientbibliotheken sind als Dienste angeordnet, die Objekte oder Klassen enthalten, die REST-Ressourcen entsprechen. Diese enthalten auch entsprechende Methoden.
- 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. Der Dienst verwendet insbesondere proto3.
Beim Aufrufen der API kann für einige Anfrage- oder Antwortfelder ein grundlegendes Verständnis der bekannten Protokollpuffertypen erforderlich sein.
Außerdem kann es beim Aufrufen der REST API aufgrund des Standardwertverhaltens für Protocol Buffers dazu kommen, dass Felder in einer JSON-Antwort fehlen. Diese Felder sind auf den Standardwert festgelegt und werden daher nicht in die Antwort aufgenommen.
API-Versionen
Die folgenden API-Versionen sind verfügbar:
- v1: Stabil.
Entwicklervorschau
In der Dokumentation werden möglicherweise API-Methoden oder ‑Felder angezeigt, die nur über das Developer Preview-Programm verfügbar sind. Wenn Sie die neuesten Vorschaufunktionen testen, eine Vorschau davon ansehen und Feedback dazu geben möchten, nehmen Sie am Entwicklervorschauprogramm teil.