Клиентские библиотеки 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

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

• Репозиторий GitHub
• Справочник по облачной клиентской библиотеке
• Быстрый старт

Ява

Выберите среду сборки на следующих вкладках. Какой бы вариант вы ни использовали, не забудьте обновить версию до самой последней версии, доступной на 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"

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

• Репозиторий GitHub
• Справочник по облачной клиентской библиотеке
• Быстрый старт

Питон

На 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

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

• Репозиторий GitHub
• Справочник по облачной клиентской библиотеке
• Быстрый старт

Идти

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

import "cloud.google.com/go"

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

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

go get cloud.google.com/go/chat

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

• Репозиторий GitHub
• Справочник по облачной клиентской библиотеке

Руби

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

gem install google-apps-chat

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

• Репозиторий GitHub
• Справочник по облачной клиентской библиотеке

PHP

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

1. При необходимости установите менеджер зависимостей Composer .
2. Из интерфейса командной строки запустите:

composer require google/apps-chat

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

• Репозиторий GitHub
• Справочник по облачной клиентской библиотеке

.СЕТЬ

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

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

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

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

• Репозиторий GitHub
• Справочник по облачной клиентской библиотеке

Установите клиентские библиотеки 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 .

JavaScript

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

.СЕТЬ

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

• Просмотрите справочную документацию по .NET для API Google Chat .
• Прочтите руководство разработчика по клиентской библиотеке Google API для .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. Дополнительные сведения см. в следующей документации:

• Просмотрите справочник PyDoc для 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

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

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

   python setup.py install

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

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

Руби

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

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

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