Клиентские библиотеки оптимизируют работу разработчиков при вызове API Google Chat за счет сокращения количества написанного шаблонного кода. В этом руководстве представлены клиентские библиотеки и объясняется, как их установить.
Chat API имеет интерфейсы gRPC и REST , а также клиентские библиотеки, поддерживающие оба. Облачные клиентские библиотеки поддерживают интерфейсы gRPC и REST, клиентские библиотеки Google API поддерживают только интерфейс REST, но вы можете использовать обе клиентские библиотеки в одном проекте. При необходимости, если предоставленные клиентские библиотеки не соответствуют вашим потребностям, вы можете написать свои собственные клиентские библиотеки, использующие интерфейс gRPC или REST.
Дополнительные сведения о типах клиентских библиотек, поддерживаемых Google, см. в разделе «Описание клиентских библиотек» .
Установите библиотеки облачных клиентов (рекомендуется)
Облачные клиентские библиотеки — это новейшие и рекомендуемые клиентские библиотеки для вызова Chat API. Облачные клиентские библиотеки поддерживают интерфейсы gRPC и REST.
Chat API предоставляет облачные клиентские библиотеки для следующих языков. Выберите язык, который вы хотите использовать:
Чтобы установить клиентскую библиотеку:
npm install @google-apps/chat
Узнать больше:
Чтобы установить клиентскую библиотеку:
python -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat
Узнать больше:
Выберите среду сборки на следующих вкладках. Какой бы вариант вы ни использовали, не забудьте обновить версию до самой последней версии, доступной на GitHub.
Если вы используете 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 без 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"
Чтобы установить пакет в вашу систему:
- Перейдите в каталог вашего проекта:
cd /my/cloud/project
. - Получите пакет, который хотите использовать:
go get cloud.google.com/go/chat
Узнать больше:
Чтобы установить клиентскую библиотеку:
gem install google-apps-chat
Узнать больше:
Чтобы установить клиентскую библиотеку:
- При необходимости установите менеджер зависимостей 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. Дополнительные сведения см. в следующей документации:
- Просмотрите справочник Javadoc по API Google Chat .
- Прочтите Руководство разработчика клиентской библиотеки Google API для Java .
Добавьте клиентскую библиотеку в свой проект
Выберите среду сборки (Maven или Gradle) на следующих вкладках:
Добавьте в файл pom.xml
следующее:
Посмотреть все версии, доступные в центральном репозитории Maven .
Добавьте в файл build.gradle
следующее:
Посмотреть все версии, доступные в центральном репозитории Maven .
Прочтите руководство разработчика клиентской библиотеки.
На этой странице содержится информация о том, как начать работу с API Google Chat с помощью клиентской библиотеки API Google для .NET. Дополнительные сведения см. в следующей документации:
Загрузка библиотеки
Установите пакет NuGet: Google.Apis .
Получите последнюю версию клиентской библиотеки Google Chat API для Node.js. Прочтите руководство разработчика клиентской библиотеки.
Получите последнюю версию клиентской библиотеки Google Chat API для Objective-C . Прочтите руководство разработчика клиентской библиотеки.
Получите последнюю версию клиентской библиотеки Google Chat API для PHP . Прочтите руководство разработчика клиентской библиотеки.
На этой странице содержится информация о том, как начать работу с API Google Chat с помощью клиентской библиотеки Google API для Python. Дополнительные сведения см. в следующей документации:
Системные требования
- Операционные системы:
- Линукс
- macOS X
- Окна
- Python 2.7 или 3.4 или выше
Установите клиентскую библиотеку
Вы можете использовать менеджер пакетов или вручную загрузить и установить клиентскую библиотеку Python:
Управляемая установка
Используйте pip или setuptools для управления вашей установкой. Возможно, вам придется сначала запустить sudo
.
- пип (предпочтительно):
pip install --upgrade google-api-python-client
- Инструменты настройки :
easy_install --upgrade google-api-python-client
Ручная установка
- Загрузите последнюю версию клиентской библиотеки для Python .
- Распакуйте код.
- Установить:
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). Некоторые методы поддерживают как аутентификацию пользователя, так и аутентификацию приложения.
Дополнительные сведения об аутентификации в чате см. в разделе Обзор аутентификации .