Клиентские библиотеки оптимизируют работу разработчиков при вызове 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
Узнать больше:
Ява
Выберите среду сборки на следующих вкладках. Какой бы вариант вы ни использовали, не забудьте обновить версию до самой последней версии, доступной на 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"
Узнать больше:
Питон
На Mac или Linux из интерфейса командной строки запустите:
python3 -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat
В Windows из интерфейса командной строки запустите:
py -m venv <your-env>
.\<your-env>\Scripts\activate
pip install google-apps-chat
Узнать больше:
Идти
Импортируйте пакеты Go для сервисов Google Cloud.
import "cloud.google.com/go"
Чтобы установить пакет в вашей системе:
- Перейдите в каталог вашего проекта:
cd /my/cloud/project
. - Получите пакет, который хотите использовать:
go get cloud.google.com/go/chat
Узнать больше:
Руби
Чтобы установить клиентскую библиотеку:
gem install google-apps-chat
Узнать больше:
PHP
Чтобы установить клиентскую библиотеку:
- При необходимости установите менеджер зависимостей Composer .
- Из интерфейса командной строки запустите:
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) на следующих вкладках: Добавьте в файл Посмотреть все версии, доступные в центральном репозитории Maven . Добавьте в файл Посмотреть все версии, доступные в центральном репозитории Maven . Добавьте клиентскую библиотеку в свой проект
pom.xml
следующее: build.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 с помощью клиентской библиотеки API Google для Python. Дополнительные сведения см. в следующей документации: Вы можете использовать менеджер пакетов или вручную загрузить и установить клиентскую библиотеку Python: Используйте pip или setuptools для управления вашей установкой. Возможно, вам придется сначала запустить Поскольку клиентские библиотеки Python не установлены в среде выполнения Python App Engine , их необходимо скопировать в свое приложение так же, как и сторонние библиотеки. Системные требования
Установите клиентскую библиотеку
Управляемая установка
sudo
.pip install --upgrade google-api-python-client
easy_install --upgrade google-api-python-client
Ручная установка
python setup.py install
Механизм приложений
Руби
На этой странице содержится информация о том, как начать работу с Google Chat API с помощью клиентской библиотеки Google API для Ruby. Дополнительные сведения см. в следующей документации: В зависимости от вашей системы вам может потребоваться добавить к этим командам Если вы еще не установили клиентскую библиотеку Google API для Ruby, установите ее с помощью Установите драгоценный камень
google-api-client
sudo
.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). Некоторые методы поддерживают как аутентификацию пользователя, так и аутентификацию приложения.
Дополнительные сведения об аутентификации в чате см. в разделе Обзор аутентификации .