Клиентские библиотеки Google Chat API

Клиентские библиотеки оптимизируют работу разработчиков при вызове API Google Chat за счет сокращения количества написанного шаблонного кода. В этом руководстве представлены клиентские библиотеки и объясняется, как их установить.

Chat API имеет интерфейсы gRPC и REST , а также клиентские библиотеки, поддерживающие оба. Облачные клиентские библиотеки поддерживают интерфейсы gRPC и REST, клиентские библиотеки Google API поддерживают только интерфейс REST, но вы можете использовать обе клиентские библиотеки в одном проекте. При необходимости, если предоставленные клиентские библиотеки не соответствуют вашим потребностям, вы можете написать свои собственные клиентские библиотеки, использующие интерфейс gRPC или REST.

Дополнительные сведения о типах клиентских библиотек, поддерживаемых Google, см. в разделе «Описание клиентских библиотек» .

Установите библиотеки облачных клиентов (рекомендуется)

Облачные клиентские библиотеки — это новейшие и рекомендуемые клиентские библиотеки для вызова Chat API. Облачные клиентские библиотеки поддерживают интерфейсы gRPC и REST.

Chat API предоставляет облачные клиентские библиотеки для следующих языков. Выберите язык, который вы хотите использовать:

Node.js

Чтобы установить клиентскую библиотеку:

npm install @google-apps/chat

Узнать больше:

Питон

Чтобы установить клиентскую библиотеку:

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

Узнать больше:

Ява

Выберите среду сборки на следующих вкладках. Какой бы вариант вы ни использовали, не забудьте обновить версию до самой последней версии, доступной на GitHub.

Maven с спецификацией

Если вы используете Maven с BOM , добавьте это в свой файл 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 без спецификации

Если вы используете Maven без BOM , добавьте это в свои зависимости:

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

Градл

Если вы используете Gradle без BOM , добавьте это в свои зависимости:

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

СБТ

Если вы используете SBT, добавьте это в свои зависимости:

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

Узнать больше:

Идти

Импортируйте пакеты Go для сервисов Google Cloud.

import "cloud.google.com/go"

Чтобы установить пакет в вашу систему:

  1. Перейдите в каталог вашего проекта: cd /my/cloud/project .
  2. Получите пакет, который хотите использовать: 
go get cloud.google.com/go/chat

Узнать больше:

Руби

Чтобы установить клиентскую библиотеку: 

gem install google-apps-chat

Узнать больше:

PHP

Чтобы установить клиентскую библиотеку:

  1. При необходимости установите менеджер зависимостей Composer .
  2. Из интерфейса командной строки запустите: 
composer require google/apps-chat

Узнать больше:

.СЕТЬ

Чтобы установить клиентскую библиотеку:

Установите пакет Google.Apps.Chat.V1 из NuGet. Добавьте его в свой проект обычным способом (например, щелкнув проект правой кнопкой мыши в Visual Studio и выбрав «Управление пакетами NuGet...»). Убедитесь, что вы включили предварительные версии пакетов (например, в пользовательском интерфейсе Visual Studio NuGet установите флажок «Включить предварительную версию»).

Чтобы установить пакет NuGet, посетите Google.Apis на NuGet.org .

Узнать больше:

Установите клиентские библиотеки Google API

Клиентские библиотеки Google API , альтернатива облачным клиентским библиотекам, обеспечивают программный доступ к Chat API с использованием ресурсов и методов REST. Возможно, вы предпочтете использовать клиентские библиотеки Google API, если вы используете язык, в котором нет облачной клиентской библиотеки, или если вы расширяете проект, который уже использует их.

Chat API предоставляет клиентские библиотеки Google API для следующих языков. Выберите язык, который вы хотите использовать:

Идти

Получите последнюю версию клиентской библиотеки Google Chat API для Go (альфа) . Прочтите руководство разработчика клиентской библиотеки.

Ява

На этой странице содержится информация о том, как начать работу с API Google Chat с помощью клиентской библиотеки API Google для Java. Дополнительные сведения см. в следующей документации:

Добавьте клиентскую библиотеку в свой проект

Выберите среду сборки (Maven или Gradle) на следующих вкладках:

JavaScript

Прочтите руководство разработчика клиентской библиотеки.

.СЕТЬ

На этой странице содержится информация о том, как начать работу с API Google Chat с помощью клиентской библиотеки API Google для .NET. Дополнительные сведения см. в следующей документации:

Загрузка библиотеки

Установите пакет NuGet: Google.Apis .

Node.js

Получите последнюю версию клиентской библиотеки Google Chat API для Node.js. Прочтите руководство разработчика клиентской библиотеки.

Объект-C

Получите последнюю версию клиентской библиотеки Google Chat API для Objective-C . Прочтите руководство разработчика клиентской библиотеки.

PHP

Получите последнюю версию клиентской библиотеки Google Chat API для PHP . Прочтите руководство разработчика клиентской библиотеки.

Питон

На этой странице содержится информация о том, как начать работу с API Google Chat с помощью клиентской библиотеки Google API для Python. Дополнительные сведения см. в следующей документации:

Системные требования

Установите клиентскую библиотеку

Вы можете использовать менеджер пакетов или вручную загрузить и установить клиентскую библиотеку Python:

Управляемая установка

Используйте pip или setuptools для управления вашей установкой. Возможно, вам придется сначала запустить sudo .

Ручная установка

  1. Загрузите последнюю версию клиентской библиотеки для Python .
  2. Распакуйте код.
  3. Установить: 
    python setup.py install

Механизм приложений

Поскольку клиентские библиотеки Python не установлены в среде выполнения Python App Engine , их необходимо скопировать в свое приложение так же, как и сторонние библиотеки.

Руби

На этой странице содержится информация о том, как начать работу с API Google Chat с помощью клиентской библиотеки API Google для Ruby. Дополнительные сведения см. в следующей документации:

Установите драгоценный камень google-api-client

В зависимости от вашей системы вам может потребоваться добавить к этим командам sudo .

Если вы еще не установили клиентскую библиотеку Google API для Ruby, установите ее с помощью RubyGems : 

gem install google-api-client

Если у вас уже установлен драгоценный камень, обновите его до последней версии: 

gem update -y google-api-client

Начало работы с клиентской библиотекой Google API для Ruby

Чтобы узнать, как сделать первый запрос, см. руководство по началу работы .

Apps Script и клиентские библиотеки

Большинству разработчиков рекомендуется вызывать API Google Chat с помощью наших официально поддерживаемых облачных клиентских библиотек для предпочитаемого вами языка, например Python, Java или Node.js.

Если вы пишете код с помощью Google Apps Script, используйте службу расширенного чата вместо установки клиентско�� библиотеки.

Аутентификация

Для вызова Chat API требуется аутентификация. Каждый метод Chat API требует либо аутентификации пользователя (для выполнения действий или доступа к данным от имени пользователя), либо аутентификации приложения (для выполнения действий или доступа к данным в качестве приложения Chat). Некоторые методы поддерживают как аутентификацию пользователя, так и аутентификацию приложения.

Дополнительные сведения об аутентификации в чате см. в разделе Обзор аутентификации .