Bibliotecas de cliente da API Google Chat

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

A API Chat tem interfaces gRPC e REST e bibliotecas de cliente compatíveis com ambas. As bibliotecas de cliente do Cloud oferecem suporte às interfaces gRPC e REST, mas as bibliotecas de cliente da API Google só oferecem suporte à interface REST. Você pode usar as duas bibliotecas de cliente no mesmo projeto. Se as bibliotecas de cliente fornecidas não atenderem às suas necessidades, você pode escrever as próprias bibliotecas que usam a interface gRPC ou REST.

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

Instalar bibliotecas de cliente do Cloud (recomendado)

As bibliotecas de cliente do Cloud são as mais recentes e recomendadas para chamar a API Chat. As bibliotecas de cliente do Google Cloud são compatíveis com as interfaces gRPC e REST.

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

Node.js

Para instalar a biblioteca de cliente:

npm install @google-apps/chat

Saiba mais:

Python

Para instalar a biblioteca de cliente:

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

Saiba mais:

Java

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

Maven com BoM

Se você estiver usando o Maven com BOM, adicione isto ao 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ê estiver usando o Maven sem BOM, adicione isto à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 o seguinte à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:

Go

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

import "cloud.google.com/go"

Para instalar o pacote no sistema:

  1. Mude para o diretório do projeto: cd /my/cloud/project.
  2. Baixe 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 da 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 pelo NuGet. Adicione-o ao projeto da maneira normal, por exemplo, clicando com o botão direito do mouse no projeto no Visual Studio e escolhendo "Gerenciar pacotes do NuGet...". Ative os pacotes de pré-lançamento. Por exemplo, na interface do usuário do NuGet do Visual Studio, marque a caixa "Include prerelease".

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

Saiba mais:

Instalar as bibliotecas de cliente das APIs do Google

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

A API Chat oferece bibliotecas de cliente da API do Google para as seguintes linguagens. Selecione o idioma que você quer usar:

Go

Confira a 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 de API do Google para Java. Para mais informações, consulte a seguinte documentação:

Adicionar a biblioteca de cliente ao 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 os primeiros passos com 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

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

Obj-C

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

PHP

Confira a 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 de API 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. Instalar: 
    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 de 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 de chamar a API Google Chat é com nossas bibliotecas de cliente do Cloud com suporte oficial para a linguagem de sua preferência, como Python, Java ou Node.js.

Se você estiver codificando com o Google Apps Script, use o serviço de chat avançado em vez de instalar uma biblioteca de cliente.

Autenticação

A chamada da API Chat exige autenticação. Cada método da API Chat exige autenticação do usuário (para realizar ações ou acessar dados em nome de um usuário) ou autenticação do app (para realizar ações ou acessar dados como um app de chat). Alguns métodos oferecem suporte à autenticação do usuário e do app.

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