Biblioteki klienta optymalizują środowisko programisty do wywoływania interfejsu Google Chat API, zmniejszając ilość kodu stałego, który musisz napisać. Z tego przewodnika dowiesz się, czym są biblioteki klienta i jak je zainstalować.
Interfejs Chat API ma interfejsy gRPC i REST oraz biblioteki klienta, które obsługują oba te interfejsy. Biblioteki klienta Cloud obsługują interfejsy gRPC i REST, a biblioteki klienta interfejsów API Google tylko interfejs REST. W tym samym projekcie możesz jednak używać obu bibliotek klienta. Jeśli udostępnione biblioteki klienta nie spełniają Twoich wymagań, możesz napisać własne biblioteki klienta, które korzystają z interfejsu gRPC lub REST.
Więcej informacji o typach bibliotek klienta obsługiwanych przez Google znajdziesz w artykule Informacje o bibliotekach klienta.
Instalowanie bibliotek klienta Cloud (zalecane)
Biblioteki klienta Cloud to najnowsze i zalecane biblioteki klienta do wywoływania interfejsu Chat API. Biblioteki klienta Cloud obsługują interfejsy gRPC i REST.
Interfejs API Chat udostępnia biblioteki klienta Cloud w tych językach: Wybierz język, którego chcesz używać:
Node.js
Aby zainstalować bibliotekę klienta:
npm install @google-apps/chatWięcej informacji:
Python
Aby zainstalować bibliotekę klienta:
python -m venv <your-env>source <your-env>/bin/activatepip install google-apps-chat
Więcej informacji:
Java
Wybierz środowisko kompilacji z następujących kart. Niezależnie od tego, którego systemu używasz, pamiętaj, aby zaktualizować wersję do najnowszej wersji dostępnej na GitHubie.
Maven z BOM
Jeśli używasz Maven z BOM, dodaj do pliku pom.xml ten kod:
<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 bez BOM
Jeśli używasz Maven bez BOM, dodaj do zależności:
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.9.0</version>
</dependency>
Gradle
Jeśli używasz Gradle bez BOM, dodaj do zależności:
implementation 'com.google.cloud:google-cloud-chat:0.10.0'
SBT
Jeśli używasz SBT, dodaj to do zależności:
libraryDependencies += "com.google.cloud" % "google-cloud-chat" % "0.10.0"
Więcej informacji:
Przeczytaj
Zaimportuj pakiety Go dla usług Google Cloud.
import "cloud.google.com/go"
Aby zainstalować pakiet w systemie:
- Przejdź do katalogu projektu:
cd /my/cloud/project. - Pobierz pakiet, którego chcesz użyć:
go get cloud.google.com/go/chatWięcej informacji:
Ruby
Aby zainstalować bibliotekę klienta:
gem install google-apps-chatWięcej informacji:
PHP
Aby zainstalować bibliotekę klienta:
- W razie potrzeby zainstaluj menedżera zależności Composer.
- W interfejsie wiersza poleceń uruchom:
composer require google/apps-chatWięcej informacji:
.NET
Aby zainstalować bibliotekę klienta:
Zainstaluj pakiet Google.Apps.Chat.V1 z NuGet. Dodaj go do projektu w zwykły sposób (np. klikając projekt prawym przyciskiem myszy w Visual Studio i wybierając „Zarządzaj pakietami NuGet…”). Upewnij się, że masz włączone pakiety w wersji wstępnej (np. w interfejsie NuGet w Visual Studio odznacz pole „Uwzględnij wersję wstępną”).
Aby zainstalować pakiet NuGet, otwórz Google.Apis na stronie NuGet.org.
Więcej informacji:
Instalowanie bibliotek klienta interfejsu API Google
Alternatywne rozwiązanie dla bibliotek klienta Cloud, biblioteki klienta interfejsów Google API, zapewniają dostęp do interfejsu API Chat za pomocą zasobów i metod REST. Jeśli używasz języka, dla którego nie ma biblioteki klienta Cloud, lub rozszerzasz projekt, który już ich używa, możesz użyć bibliotek klienta interfejsu API Google.
Interfejs API czatu udostępnia biblioteki klienta interfejsu API Google w tych językach: Wybierz język, którego chcesz używać:
Przeczytaj
Pobierz najnowszą bibliotekę klienta interfejsu Google Chat API dla języka Go (alfa). Przeczytaj przewodnik programisty dotyczący biblioteki klienta.
Java
Ta strona zawiera informacje dla początkujących na temat korzystania z interfejsu Google Chat API i biblioteki klienta interfejsu API Google dla języka Java. Więcej informacji znajdziesz w tych zasobach:
Dodawanie biblioteki klienta do projektu
Wybierz swoje środowisko kompilacji (Maven lub Gradle) z następujących kart:
Dodaj do pliku pom.xml te informacje:
Zobacz wszystkie wersje dostępne w Centralnym repozytorium Maven.
Dodaj do pliku build.gradle te informacje:
Zobacz wszystkie wersje dostępne w Centralnym repozytorium Maven.
JavaScript
Przeczytaj przewodnik programisty dotyczący biblioteki klienta.
.NET
Ta strona zawiera informacje dla początkujących na temat korzystania z interfejsu Google Chat API i biblioteki klienta interfejsu API Google dla języka .NET. Więcej informacji znajdziesz w tych zasobach:
Pobieranie biblioteki
Zainstaluj pakiet NuGet: Google.Apis.
Node.js
Pobierz najnowszą bibliotekę klienta interfejsu Google Chat API dla Node.js. Przeczytaj przewodnik programisty dotyczący biblioteki klienta.
Obj-C
Pobierz najnowszą bibliotekę klienta interfejsu Google Chat API dla języka Objective-C. Przeczytaj przewodnik programisty dotyczący biblioteki klienta.
PHP
Pobierz najnowszą bibliotekę klienta interfejsu Google Chat API dla języka PHP. Przeczytaj przewodnik programisty dotyczący biblioteki klienta.
Python
Ta strona zawiera informacje dla początkujących na temat korzystania z interfejsu Google Chat API i biblioteki klienta interfejsu API Google dla języka Python. Więcej informacji znajdziesz w tych zasobach:
Wymagania systemowe
- Systemy operacyjne:
- Linux
- macOS X;
- Windows
- Python 2.7, 3.4 lub nowszy.
Instalowanie biblioteki klienta
Możesz użyć menedżera pakietów lub ręcznie pobrać i zainstalować bibliotekę klienta dla języka Python:
Instalacja zarządzana
Użyj pakietu pip lub setuptools do zarządzania instalacją. Najpierw konieczne może być uruchomienie programu sudo.
- pip (preferowany):
pip install --upgrade google-api-python-client
- Setuptools:
easy_install --upgrade google-api-python-client
Instalacja ręczna
- Pobierz najnowszą bibliotekę klienta dla języka Python
- Rozpakuj kod.
- Zainstaluj:
python setup.py install
App Engine
Biblioteki klienta dla języka Python nie są instalowane w środowisku wykonawczym App Engine Python, więc trzeba je skopiować do aplikacji, tak jak biblioteki innych dostawców.
Ruby
Ta strona zawiera informacje dla początkujących na temat korzystania z interfejsu Google Chat API i biblioteki klienta interfejsu API Google dla języka Ruby. Więcej informacji znajdziesz w tych zasobach:
Instalowanie gemu google-api-client
Zależnie od systemu konieczne może być poprzedzenie tych poleceń elementem sudo.
Jeśli nie masz jeszcze zainstalowanej biblioteki klienta interfejsu API Google dla języka Ruby, zainstaluj ją, używając elementu RubyGems:
gem install google-api-client
Jeśli masz już zainstalowany gem, zaktualizuj go do najnowszej wersji:
gem update -y google-api-client
Rozpoczynanie pracy z biblioteką klienta interfejsu API Google do języka Ruby
Informacje o tym, jak przesłać pierwszą prośbę, znajdziesz w przewodniku dla początkujących.
Apps Script i biblioteki klienta
Zalecany sposób wywoływania interfejsu Google Chat API przez większość deweloperów to użycie oficjalnie obsługiwanych bibliotek klienta Cloud w wybranym języku, np. Python, Java lub Node.js.
Jeśli kodujesz za pomocą Google Apps Script, zamiast instalować bibliotekę klienta, użyj usługi Google Chat zaawansowanej.
Uwierzytelnianie
Wywoływanie interfejsu Chat API wymaga uwierzytelnienia. Każda metoda interfejsu Chat API wymaga uwierzytelniania użytkownika (aby wykonywać działania lub uzyskiwać dostęp do danych w imieniu użytkownika) lub uwierzytelniania aplikacji (aby wykonywać działania lub uzyskiwać dostęp do danych jako aplikacja Google Chat). Niektóre metody obsługują zarówno uwierzytelnianie użytkownika, jak i aplikacji.
Więcej informacji o uwierzytelnianiu w Google Chat znajdziesz w artykule Omówienie uwierzytelniania.