Клиентские библиотеки 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). Некоторые методы поддерживают как аутентификацию пользователя, так и аутентификацию приложения.

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