Bibliotecas de cliente da API Google Chat

As bibliotecas de cliente otimizam a experiência do desenvolvedor para chamar a API Google Chat reduzindo o código boilerplate que você precisa escrever. Este guia apresenta a bibliotecas de cliente e explica como instalá-las.

A API Chat tem gRPC e REST interfaces e bibliotecas de cliente compatíveis com ambos. As bibliotecas de cliente do Cloud oferecem suporte a gRPC e REST as interfaces de cliente, as bibliotecas de cliente das APIs do Google oferecem suporte apenas à interface REST, mas é podem usar ambas as bibliotecas de cliente no mesmo projeto. Opcionalmente, se as bibliotecas de cliente fornecidas não atenderem às suas necessidades, crie seu próprio bibliotecas de cliente que usam a interface gRPC ou REST.

Para saber mais sobre os tipos de biblioteca de cliente com suporte do Google, consulte Explicações sobre bibliotecas de cliente.

Instalar bibliotecas de cliente do Cloud (recomendado)

Bibliotecas de cliente do Cloud as bibliotecas de cliente mais recentes e recomendadas para chamar API Chat. As bibliotecas de cliente do Cloud oferecem suporte a gRPC e REST do Google Cloud.

A API Chat fornece bibliotecas de cliente do Cloud para as linguagens a seguir. Selecione o idioma que você quer usar:

Node.js

Para instalar a biblioteca de cliente:

npm install @google-apps/chat

Saiba mais:

Java

Selecione seu ambiente de build nas guias a seguir. Seja qual for você use, lembre-se de atualizar a versão para a versão mais recente disponível no o GitHub.

Maven com BoM

Se você usa o Maven com BOM, adicione isto ao seu arquivo 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 sem BOM

Se você usar o Maven sem BOM, adicione este código às dependências:

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

Gradle

Se você estiver usando o Gradle sem BOM, adicione este código às dependências:

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

SBT

Se você usa SBT, adicione este código às dependências:

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

Saiba mais:

Python

Em um Mac ou Linux, na interface da linha de comando, execute:

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

No Windows, na interface de linha de comando, execute:

py -m venv <your-env>
.\<your-env>\Scripts\activate
pip install google-apps-chat

Saiba mais:

Go

Importe os pacotes Go para os serviços do Google Cloud.

import "cloud.google.com/go"

Para instalar o pacote no seu sistema:

  1. Mude para o diretório do seu projeto: cd /my/cloud/project.
  2. Acesse o pacote que você quer usar:
go get cloud.google.com/go/chat

Saiba mais:

Ruby

Para instalar a biblioteca de cliente:

gem install google-apps-chat

Saiba mais:

PHP

Para instalar a biblioteca de cliente:

  1. Se necessário, instale o gerenciador de dependências Composer:
  2. Na interface de linha de comando, execute:
composer require google/apps-chat

Saiba mais:

.NET

Para instalar a biblioteca de cliente:

Instale o pacote Google.Apps.Chat.V1 do NuGet. Adicione à sua projeto da maneira normal (por exemplo, clicando com o botão direito do mouse no projeto Visual Studio e escolha "Gerenciar pacotes NuGet..."). Certifique-se de ativar pacotes de pré-lançamento (por exemplo, na solicitação de usuário da interface, marque a opção "Incluir pré-lançamento" caixa).

Para instalar o pacote NuGet, visite Google.Apis em NuGet.org.

Saiba mais:

Instalar bibliotecas de cliente das APIs do Google

Uma alternativa às bibliotecas de cliente do Cloud, Bibliotecas de cliente das APIs do Google acesso programático à API Chat usando recursos REST e métodos. Talvez você prefira usar Bibliotecas de cliente das APIs do Google, se você usa uma linguagem que não tem ou se você estiver estendendo um projeto que já as utiliza.

A API Chat oferece bibliotecas de cliente das APIs do Google para as funções abaixo: idiomas. Selecione o idioma que você quer usar:

Go

Faça o download da biblioteca de cliente da API Google Chat para Go (Alfa) mais recente. Leia o guia do desenvolvedor da biblioteca de cliente.

Java

Esta página contém informações sobre como começar a usar a API Google Chat usando a biblioteca de cliente das APIs do Google para Java. Para mais informações, consulte a seguinte documentação:

Adicionar a biblioteca de cliente ao seu projeto

Selecione o ambiente de build (Maven ou Gradle) nas guias abaixo:

JavaScript

Leia o guia do desenvolvedor da biblioteca de cliente.

.NET

Esta página contém informações sobre como começar a usar a API Google Chat usando a biblioteca de cliente da API do Google para .NET. Para mais informações, consulte a seguinte documentação:

Download da biblioteca

Instale o pacote NuGet: Google.Apis.

Node.js

Faça o download da biblioteca de cliente da API Google Chat para Node.js mais recente. Leia o guia do desenvolvedor da biblioteca de cliente.

Obj-C

Faça o download da biblioteca de cliente da API Google Chat para Objective-C mais recente. Leia o guia do desenvolvedor da biblioteca de cliente.

PHP

Faça o download da biblioteca de cliente da API Google Chat para PHP mais recente. Leia o guia do desenvolvedor da biblioteca de cliente.

Python

Esta página contém informações sobre como começar a usar a API Google Chat usando a biblioteca de cliente das APIs do Google para Python. Para mais informações, consulte a seguinte documentação:

Requisitos do sistema

Instale a biblioteca cliente

Você pode usar um gerenciador de pacotes ou fazer o download e instalar a biblioteca de cliente do Python manualmente:

Instalação gerenciada

Use pip ou setuptools para gerenciar sua instalação. Talvez seja necessário executar primeiro sudo:

  • pip (preferencial): 
    pip install --upgrade google-api-python-client
  • Setuptools: 
    easy_install --upgrade google-api-python-client

Instalação manual

  1. Faça o download da biblioteca de cliente mais recente para Python.
  2. Descompacte o código.
  3. Instale: 
    python setup.py install

App Engine

Como as bibliotecas de cliente do Python não estão instaladas no ambiente de execução do App Engine para Python, é preciso copiá-las no aplicativo da mesma forma que as bibliotecas de terceiros.

Ruby

Esta página contém informações sobre como começar a usar a API Google Chat usando a biblioteca de cliente da API do Google para Ruby. Para mais informações, consulte a seguinte documentação:

Instalar a gem google-api-client

Dependendo do sistema, talvez seja necessário prefixar esses comandos com sudo.

Se você nunca instalou a biblioteca de cliente da API do Google para Ruby, faça isso usando RubyGems: 

gem install google-api-client

Caso você já tenha a gem instalada, atualize para a versão mais recente: 

gem update -y google-api-client

Primeiros passos com a biblioteca de cliente de APIs do Google para Ruby

Para saber como fazer sua primeira solicitação, consulte o guia de iniciação.

Apps Script e bibliotecas de cliente

A maneira recomendada para a maioria dos desenvolvedores chamar a API Google Chat é com nossa plataforma Bibliotecas de cliente do Cloud para sua linguagem preferida, como Python, Java ou Node.js.

Se você estiver codificando com o Google Apps Script, use a Serviço avançado do Chat em vez de instalar uma biblioteca de cliente.

Autenticação

Chamar a API Chat requer autenticação. Cada O método da API Chat exige autenticação de usuários (para realizar ações ou acessar em nome de um usuário) ou autenticação de apps (para realizar ações ou acessar dados como um app do Chat). Algumas oferecem suporte à autenticação do usuário e do aplicativo.

Para saber mais sobre a autenticação no Chat, consulte Visão geral da autenticação.