Google Chat API-Clientbibliotheken

Clientbibliotheken optimieren die Entwicklung für den Aufruf der Google Chat API, indem der Boilerplate-Code reduziert wird, den Sie schreiben müssen. In diesem Leitfaden werden die Clientbibliotheken vorgestellt und ihre Installation beschrieben.

Die Chat API hat gRPC- und REST-Schnittstellen sowie Clientbibliotheken, die beide unterstützen. Cloud-Clientbibliotheken unterstützen gRPC- und REST-Schnittstellen, Google API-Clientbibliotheken nur die REST-Schnittstelle. Sie können jedoch beide Clientbibliotheken im selben Projekt verwenden. Falls die bereitgestellten Clientbibliotheken nicht Ihren Anforderungen entsprechen, können Sie eigene Clientbibliotheken mit der gRPC- oder REST-Schnittstelle schreiben.

Weitere Informationen zu den von Google unterstützten Clientbibliotheken finden Sie unter Erläuterung zu Clientbibliotheken.

Cloud-Clientbibliotheken installieren (empfohlen)

Cloud-Clientbibliotheken sind die neuesten und empfohlenen Clientbibliotheken zum Aufrufen der Chat API. Cloud-Clientbibliotheken unterstützen sowohl gRPC- als auch REST-Schnittstellen.

Die Chat API bietet Cloud-Clientbibliotheken für die folgenden Sprachen. Wählen Sie die gewünschte Sprache aus:

Node.js

So installieren Sie die Clientbibliothek:

npm install @google-apps/chat

Weitere Informationen:

Python

So installieren Sie die Clientbibliothek:

python -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat

Weitere Informationen:

Java

Wähle über die folgenden Tabs deine Build-Umgebung aus. Denken Sie daran, die Version auf die neueste auf GitHub verfügbare Version zu aktualisieren.

Maven mit BOM

Wenn Sie Maven mit BOM verwenden, fügen Sie der Datei pom.xml Folgendes hinzu:

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>com.google.cloud</groupId>
        <artifactId>libraries-bom</artifactId>
        <version>26.42.0</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>

  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>google-cloud-chat</artifactId>
    </dependency>

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-chat</artifactId>
  <version>0.10.0</version>
</dependency>

Maven ohne BOM

Wenn Sie Maven ohne BOM verwenden, fügen Sie Ihren Abhängigkeiten Folgendes hinzu:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-chat</artifactId>
  <version>0.9.0</version>
</dependency>

Gradle

Wenn Sie Gradle ohne BOM verwenden, fügen Sie Ihren Abhängigkeiten Folgendes hinzu:

implementation 'com.google.cloud:google-cloud-chat:0.10.0'

SBT

Wenn Sie SBT verwenden, fügen Sie den Abhängigkeiten Folgendes hinzu:

libraryDependencies += "com.google.cloud" % "google-cloud-chat" % "0.10.0"

Weitere Informationen:

Ok

Importieren Sie die Go-Pakete für Google Cloud-Dienste.

import "cloud.google.com/go"

So installieren Sie das Paket auf Ihrem System:

  1. Wechseln Sie zum Projektverzeichnis: cd /my/cloud/project.
  2. Holen Sie sich das gewünschte Paket:
go get cloud.google.com/go/chat

Weitere Informationen:

Ruby

So installieren Sie die Clientbibliothek:

gem install google-apps-chat

Weitere Informationen:

PHP

So installieren Sie die Clientbibliothek:

  1. Installieren Sie gegebenenfalls den Abhängigkeitsmanager Composer.
  2. Führen Sie in der Befehlszeile folgenden Befehl aus:
composer require google/apps-chat

Weitere Informationen:

.NET

So installieren Sie die Clientbibliothek:

Installieren Sie das Paket Google.Apps.Chat.V1 von NuGet. Fügen Sie es wie gewohnt zu Ihrem Projekt hinzu (z. B. indem Sie mit der rechten Maustaste auf das Projekt in Visual Studio klicken und „NuGet-Pakete verwalten…“ auswählen). Aktivieren Sie Vorabversionspakete (beispielsweise in der Benutzeroberfläche von Visual Studio NuGet mithilfe des Kästchens „Vorabversion einbeziehen“).

Informationen zum Installieren des NuGet-Pakets finden Sie unter Google.Apis bei NuGet.org.

Weitere Informationen:

Google API-Clientbibliotheken installieren

Google API-Clientbibliotheken sind eine Alternative zu Cloud-Clientbibliotheken und bieten programmatischen Zugriff auf die Chat API mithilfe von REST-Ressourcen und ‑Methoden. Sie sollten Google API-Clientbibliotheken verwenden, wenn Sie eine Sprache verwenden, für die es keine Cloud-Clientbibliothek gibt, oder wenn Sie ein Projekt erweitern, in dem sie bereits verwendet werden.

Die Chat API bietet Google API-Clientbibliotheken für die folgenden Sprachen. Wählen Sie die gewünschte Sprache aus:

Ok

Die aktuelle Google Chat API-Clientbibliothek für Go (Alpha) finden Sie hier. Sieh dir den Entwicklerleitfaden zur Clientbibliothek an.

Java

Diese Seite enthält Informationen zu den ersten Schritten mit der Google Chat API unter Einsatz der Google API-Clientbibliothek für Java. Weitere Informationen erhalten Sie in dieser Dokumentation:

Clientbibliothek zum Projekt hinzufügen

Wähle über die folgenden Tabs deine Build-Umgebung (Maven oder Gradle) aus:

Gradle

Füge deiner Datei build.gradle Folgendes hinzu:

Im Maven Central Repository findest du alle verfügbaren Versionen.

JavaScript

Sieh dir den Entwicklerleitfaden zur Clientbibliothek an.

.NET

Diese Seite enthält Informationen zur Verwendung der Google Chat API mit der Google API-Clientbibliothek für .NET. Weitere Informationen findest du in der folgenden Dokumentation:

Bibliothek herunterladen

Installiere das NuGet-Paket: Google.Apis.

Node.js

Rufen Sie die aktuelle Google Chat API-Clientbibliothek für Node.js ab. Sieh dir den Entwicklerleitfaden zur Clientbibliothek an.

Obj-C

Rufen Sie die aktuelle Google Chat API-Clientbibliothek für Objective-C ab. Sieh dir den Entwicklerleitfaden zur Clientbibliothek an.

PHP

Lade die neueste Google Chat API-Clientbibliothek für PHP herunter. Sieh dir den Entwicklerleitfaden zur Clientbibliothek an.

Python

Diese Seite enthält Informationen zur Verwendung der Google Chat API mit der Google API-Clientbibliothek für Python. Weitere Informationen erhalten Sie in dieser Dokumentation:

Systemanforderungen

Clientbibliothek installieren

Du kannst entweder einen Paketmanager verwenden oder die Python-Clientbibliothek manuell herunterladen und installieren:

Verwaltete Installation

Verwende „pip“ oder „setuptools“, um die Installation zu verwalten (möglicherweise musst du zuerst sudo ausführen).

  • pip (bevorzugt): 
    pip install --upgrade google-api-python-client
  • Setuptools: 
    easy_install --upgrade google-api-python-client

Manuelle Installation

  1. Lade die aktuelle Clientbibliothek für Python herunter.
  2. Entpacke den Code.
  3. Führe die Installation durch: 
    python setup.py install

App Engine

Da die Python-Clientbibliotheken nicht in der Python-Laufzeitumgebung von App Engine installiert sind, musst du sie wie Drittanbieterbibliotheken in deine Anwendung kopieren.

Ruby

Diese Seite enthält Informationen zur Verwendung der Google Chat API mit der Google API-Clientbibliothek für Ruby. Weitere Informationen erhalten Sie in dieser Dokumentation:

google-api-client-Gem installieren

Je nach System musst du diesen Befehlen den Ausdruck sudo voranstellen.

Wenn du die Google API-Clientbibliothek für Ruby noch nicht installiert hast, installiere sie mit RubyGems: 

gem install google-api-client

Wenn das Gem bereits installiert ist, aktualisiere es auf die neueste Version: 

gem update -y google-api-client

Google API-Clientbibliothek für Ruby verwenden

Informationen zum Erstellen deiner ersten Anfrage findest du im Startleitfaden.

Apps Script und 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.

Authentifizierung

Für den Aufruf der Chat API ist eine Authentifizierung erforderlich. Für jede Chat API-Methode ist entweder eine Nutzerauthentifizierung (um Aktionen auszuführen oder im Namen eines Nutzers auf Daten zuzugreifen) oder eine App-Authentifizierung (um Aktionen auszuführen oder als Chat-App auf Daten zuzugreifen) erforderlich. Einige Methoden unterstützen sowohl die Nutzerauthentifizierung als auch die App-Authentifizierung.

Weitere Informationen zur Authentifizierung in Google Chat finden Sie unter Authentifizierung.