Biblioteki klienta interfejsu Google Chat API

Biblioteki klienta optymalizują środowisko programistów pod kątem wywoływania interfejsu Google Chat API ograniczając powtarzalny kod. W tym przewodniku omawiamy bibliotek klienta i wyjaśnia, jak je instalować.

Interfejs Chat API ma gRPC oraz REST a także z bibliotekami klienckimi, które obsługują oba te typy. Biblioteki klienta Cloud obsługują gRPC i REST , biblioteki klienta interfejsów API Google obsługują tylko interfejs REST, ale możesz używać obu bibliotek klienta w tym samym projekcie. Opcjonalnie, jeśli podane biblioteki klienta nie spełniają Twoich wymagań, możesz napisać własne bibliotek klienta korzystających z interfejsu gRPC lub REST.

Aby dowiedzieć się więcej o: typów bibliotek klienta obsługiwanych przez Google, Biblioteki klienta.

Instalowanie bibliotek klienta Cloud (zalecane)

Biblioteki klienta Cloud to najnowsze i zalecane biblioteki klienta do wywoływania Interfejs Chat API. Biblioteki klienta Cloud obsługują zarówno gRPC, jak i REST i interfejsów.

Chat API 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/chat

Więcej informacji:

Python

Aby zainstalować bibliotekę klienta:

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

Więcej informacji:

Java

Wybierz środowisko kompilacji z kart poniżej. Bez względu na to, pamiętaj, aby zaktualizować go do najnowszej wersji dostępnej GitHub.

Maven z BOM

Jeśli używasz narzędzia Maven z BOM, dodaj to do pliku pom.xml:

  <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 to 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 to do zależności:

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

SBT

Jeśli używasz SBT, dodaj do zależności:

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

Więcej informacji:

Przeczytaj

Zaimportuj pakiety w języku Go dla usług Google Cloud.

import "cloud.google.com/go"

Aby zainstalować pakiet w swoim systemie:

  1. Przejdź do katalogu projektu: cd /my/cloud/project.
  2. Wybierz pakiet, którego chcesz użyć:
go get cloud.google.com/go/chat

Więcej informacji:

Ruby

Aby zainstalować bibliotekę klienta:

gem install google-apps-chat

Więcej informacji:

PHP

Aby zainstalować bibliotekę klienta:

  1. W razie potrzeby zainstaluj menedżera zależności Kompozytor
  2. W interfejsie wiersza poleceń uruchom polecenie:
composer require google/apps-chat

Więcej informacji:

.NET

Aby zainstalować bibliotekę klienta:

Zainstaluj pakiet Google.Apps.Chat.V1 z NuGet. Dodaj do w normalny sposób (np. klikając projekt prawym przyciskiem myszy Visual Studio i wybranie „Zarządzaj pakietami NuGet...”). Upewnij się, że włącz pakiety przedpremierowe (na przykład w interfejsie Visual Studio NuGet zaznacz pole wyboru „Dołącz wersję przedpremierową”, ).

Aby zainstalować pakiet NuGet, wejdź na Google.Apis na NuGet.org.

Więcej informacji:

Instalowanie bibliotek klienta interfejsów API Google

Alternatywa dla bibliotek klienta Cloud: Biblioteki klienta interfejsów API Google zapewnić programowy dostęp do interfejsu Chat API za pomocą zasobów REST; . Może wolisz użyć atrybutu bibliotek klienta interfejsów API Google, jeśli używasz języka, który nie ma biblioteki klienta Cloud lub rozszerzasz projekt, który już z nich korzysta.

Chat API udostępnia biblioteki klienta interfejsów API Google do: języki. 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

Na tej stronie znajdziesz informacje na temat rozpoczynania pracy z interfejsem Google Chat API za pomocą i bibliotekę klienta interfejsów API Google do 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:

JavaScript

Przeczytaj przewodnik programisty dotyczący biblioteki klienta.

.NET

Na tej stronie znajdziesz informacje na temat rozpoczynania pracy z interfejsem Google Chat API za pomocą z biblioteką klienta interfejsów API Google dla .NET. Więcej informacji znajdziesz w tej dokumentacji:

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

Na tej stronie znajdziesz informacje na temat rozpoczynania pracy z interfejsem Google Chat API za pomocą i bibliotekę klienta interfejsów API Google do języka Python. Więcej informacji znajdziesz w tych zasobach:

Wymagania systemowe

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

  1. Pobierz najnowszą bibliotekę klienta dla języka Python
  2. Rozpakuj kod.
  3. 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

Na tej stronie znajdziesz informacje na temat rozpoczynania pracy z interfejsem Google Chat API za pomocą i bibliotekę klienta interfejsów API Google do 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 jest oficjalnie obsługiwany Biblioteki klienta Cloud na wybrany język, np. Pythona, Java czy Node.js.

Jeśli programujesz za pomocą Google Apps Script, użyj Zaawansowana usługa czatu zamiast instalować bibliotekę klienta.

Uwierzytelnianie

Wywołanie interfejsu Chat API wymaga uwierzytelnienia. Każdy Metoda interfejsu Chat API wymaga: uwierzytelnianie użytkownika, (aby wykonywać działania lub otwierać danych w imieniu użytkownika) lub uwierzytelnianie aplikacji (aby wykonywać działania lub uzyskiwać dostęp do danych jako aplikacja Google Chat). Niektóre obsługują zarówno uwierzytelnianie użytkownika, jak i uwierzytelnianie aplikacji.

Więcej informacji o uwierzytelnianiu w Google Chat znajdziesz w artykule Omówienie uwierzytelniania.